- 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": 226626,
"articles": [
{
"id": "2ee89cb241c6b7e74c9389029c9b9ae7",
"title": "Iran War Live Updates: Tehran Hit by Heavy Airstrikes as U.S. Marines Arrive in Middle East",
"description": "Airstrikes pummel residential areas and a university in Iran’s capital. Houthi forces in Yemen entered the widening conflict with a missile attack on Israel.",
"content": "President Trump said on Friday that indirect negotiations with Iranian leaders were underway in an effort to reach a truce, but the Marines give U.S. commanders more options for securing the Strait of Hormuz, which Iranian forces have effectively clo... [16134 chars]",
"url": "https://www.nytimes.com/live/2026/03/29/world/iran-war-trump-israel-oil",
"image": "https://static01.nyt.com/images/2026/03/29/multimedia/29israel-iran-promo-zgkh/29israel-iran-promo-zgkh-facebookJumbo.jpg",
"publishedAt": "2026-03-29T04:28:11Z",
"lang": "en",
"source": {
"id": "2f580dc49292a1caf59cd86dd3c9e60b",
"name": "nytimes.com",
"url": "https://www.nytimes.com"
}
},
{
"id": "971efe94b2274441913dc6509b801215",
"title": "Iran Update Special Report, March 28, 2026",
"description": "he Houthis conducted a ballistic missile attack and a drone and cruise missile attack targeting southern Israel on March 27 and 28",
"content": "The Institute for the Study of War (ISW) and The Critical Threats Project (CTP) at the American Enterprise Institute are publishing daily updates to provide analysis on the war with Iran. The updates focus on US and Israeli strikes on Iran and Iran a... [342 chars]",
"url": "https://understandingwar.org/research/middle-east/iran-update-special-report-march-28-2026/",
"image": "https://understandingwar.org/wp-content/uploads/2025/10/Website-Featured-Image-1-scaled.webp",
"publishedAt": "2026-03-29T01:37:52Z",
"lang": "en",
"source": {
"id": "41fdc887bd765811a368dcd8b6dd6835",
"name": "understandingwar.org",
"url": "https://understandingwar.org"
}
},
{
"id": "ee65a0728cc99b1598748b3793974e65",
"title": "The ripple effect of the Iran war on struggling U.S. farmers: \"It couldn't have come at a worst time\"",
"description": "The price of ammonia and urea, two fertilizer ingredients seeing disruptions, are up around 20% and 50%, respectively, since the start of the Iran war.",
"content": "Vinton, Iowa — Lance Lillibridge of Vinton, Iowa, has been farming his whole life, and says he's worried for this year's spring planting.\n\"It couldn't have come at a worst time,\" Lillibridge told CBS News of the Iran war.\nThe war has led to skyrocket... [1552 chars]",
"url": "https://www.cbsnews.com/news/ripple-effect-iran-war-struggling-u-s-farmers/",
"image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/03/29/553d5512-5a51-47cf-acd5-64fdef3874ea/thumbnail/1200x630/16c1e4ef4015c4a38dc156f6cf5845e0/1774743718409.png",
"publishedAt": "2026-03-29T00:44:00Z",
"lang": "en",
"source": {
"id": "f2f2ed82d991515dcc85d86a1374a9ae",
"name": "CBS News",
"url": "https://www.cbsnews.com"
}
}
]
}