- Argentina
- Australia
- Austria
- Bangladesh
- Belgium
- Botswana
- Brazil
- Bulgaria
- Canada
- Chile
- China
- Colombia
- Cuba
- Czech Republic
- Egypt
- Estonia
- Ethiopia
- Finland
- France
- Germany
- Ghana
- Greece
- Hong Kong
- Hungary
- India
- Indonesia
- Ireland
- Israel
- Italy
- Japan
- Kenya
- Latvia
- Lebanon
- Lithuania
- Malaysia
- Mexico
- Morocco
- Namibia
- Netherlands
- New Zealand
- Nigeria
- Norway
- Pakistan
- Peru
- Philippines
- Poland
- Portugal
- Romania
- Russia
- Saudi Arabia
- Senegal
- Singapore
- Slovakia
- Slovenia
- South Africa
- South Korea
- Spain
- Sweden
- Switzerland
- Taiwan
- Tanzania
- Thailand
- Turkey
- Uganda
- Ukraine
- United Arab Emirates
- United Kingdom
- United States
- Venezuela
- Vietnam
- Zimbabwe
United States World News API
Get the live top world headlines from United States with our JSON API.
Get API key for the United States World News APIAPI Demonstration
This example demonstrates the HTTP request to make and the JSON response you will receive when you use the news api to get the top headlines from United States.
GET
https://gnews.io/api/v4/top-headlines?country=us&category=world&apikey=API_KEY
{
"totalArticles": 245386,
"articles": [
{
"id": "5d72f4757e98eb88ad8d44352f880206",
"title": "Iran War Live Updates: Trump Says Peace Deal Is Near",
"description": "President Trump said Iran and the United States had “largely negotiated” an agreement “pertaining to PEACE.” Three senior Iranian officials said Tehran had agreed to a memorandum of understanding, but there was no public statement from Iran’s government.",
"content": "In a post on Truth Social, Mr. Trump said he had spoken by phone with several Arab leaders about a memorandum of understanding “pertaining to PEACE.” He said the agreement was “subject to finalization” by the United States, Iran and other countries.\n... [10466 chars]",
"url": "https://www.nytimes.com/live/2026/05/23/world/us-iran-war-trump",
"image": "https://static01.nyt.com/images/2026/05/23/multimedia/00mideast-promo-8pm-mwkz/00mideast-promo-8pm-mwkz-facebookJumbo.jpg",
"publishedAt": "2026-05-23T23:59:24Z",
"lang": "en",
"source": {
"id": "2f580dc49292a1caf59cd86dd3c9e60b",
"name": "The New York Times",
"url": "https://www.nytimes.com"
}
},
{
"id": "d6893a2559d738fea6f5cb106916f299",
"title": "Rosenberg: Luhansk strike sparks Russian accusations and vow to retaliate",
"description": "Eighteen people were killed and 42 others injured in the strike on the town in Russian-occupied eastern Ukraine.",
"content": "What happened here early on Friday has sparked Russian accusations, Ukrainian denials, an emergency session of the United Nations Security Council and vows of retribution by the Kremlin.\nThe town of Starobilsk is in Russian-occupied eastern Ukraine: ... [1559 chars]",
"url": "https://www.bbc.com/news/articles/cvgz05jyrrpo",
"image": "https://ichef.bbci.co.uk/news/1024/branded_news/44ff/live/6628b250-56f7-11f1-89a3-d1f559421220.jpg",
"publishedAt": "2026-05-23T23:34:33Z",
"lang": "en",
"source": {
"id": "f331a5ed3965fb59761dfcecfc7e7a34",
"name": "BBC",
"url": "https://www.bbc.com"
}
},
{
"id": "1d880c38a6506518be9732ab67d97a29",
"title": "Britain Preparing for Mission That Could Clear Strait of Hormuz",
"description": "At Gibraltar, at the tip of Spain, British forces are ready to deploy autonomous mine-hunting equipment if a peace agreement is achieved.",
"content": "President Trump has fumed repeatedly about Britain’s failing to help the U.S. wage war on Iran. The United Kingdom responded by allowing U.S. bombers to strike Iran from southern England, while Britain’s fighter jets have flown thousands of defensive... [1573 chars]",
"url": "https://www.nytimes.com/2026/05/23/us/politics/britain-strait-of-hormuz-iran.html",
"image": "https://static01.nyt.com/images/2026/05/23/world/23int-uk-gibraltar/23int-uk-gibraltar-facebookJumbo.jpg",
"publishedAt": "2026-05-23T23:00:06Z",
"lang": "en",
"source": {
"id": "2f580dc49292a1caf59cd86dd3c9e60b",
"name": "The New York Times",
"url": "https://www.nytimes.com"
}
}
]
}