Flag of United States

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 API

API 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": 228288,
    "articles": [
        {
            "id": "ccefd46a3898e70426b5c6ecb49e8612",
            "title": "US, Israel and Iran agree to a 2-week ceasefire but much remains unclear",
            "description": "Iran, the United States and Israel have agreed to a two-week ceasefire. The 11th-hour deal headed off U.S.",
            "content": "TEHRAN, Iran (AP) — Iran, the United States and Israel agreed to a two-week ceasefire in an 11th-hour deal that headed off U.S. President Donald Trump’s threat to unleash a bombing campaign to destroy Iranian civilization. But hours after the announc... [8680 chars]",
            "url": "https://apnews.com/article/iran-us-israel-trump-lebanon-april-8-2026-38d75d5e4f1c7339a1456fc99415bb2a",
            "image": "https://dims.apnews.com/dims4/default/e7d8f65/2147483647/strip/true/crop/8640x5757+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F30%2F39%2Faf5de3be61a8756ed9b2559d7e39%2F6f1f7f22e2e5485b93518cef408ffb07",
            "publishedAt": "2026-04-08T13:44:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "cf2a861d8990e3dbcad4d0d1e09dcc34",
            "title": "Germany accuses JD Vance of hypocrisy over claim that EU meddled in Hungary’s election",
            "description": "Government spokesperson remarks that the U.S. vice president may himself be guilty of interfering in the vote.",
            "content": "BERLIN — Germany on Wednesday chided JD Vance for hypocrisy, as it pushed back against the U.S. vice president’s accusation that Brussels was meddling in Hungary’s election.\nBerlin said that, on the contrary, Vance’s visit to Budapest shortly before ... [2047 chars]",
            "url": "https://www.politico.eu/article/germany-rebuke-jd-vance-claim-eu-interferes-hungary-election/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2026/04/08/GettyImages-2226765517-scaled.jpg",
            "publishedAt": "2026-04-08T12:30:01Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu"
            }
        },
        {
            "id": "ef23fa4a228012c3b727e94844789c5b",
            "title": "Live updates: Iran war, Trump agrees to ceasefire on the condition the Strait of Hormuz is reopened",
            "description": "Iran says its military will coordinate passage through the Strait of Hormuz. Meanwhile, Pakistan has invited Iran and the US to Islamabad for talks on Friday. Follow for live updates.",
            "content": "President Donald Trump said the US will work with Iran to dig up and remove buried uranium in the country in a social media post that came as a fragile new two-week ceasefire began.\nTrump also said sanctions relief for Iran will be discussed and that... [9434 chars]",
            "url": "https://www.cnn.com/2026/04/08/world/live-news/iran-war-trump-us-ceasefire",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2270123160.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-04-08T11:09:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories