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": 237078,
    "articles": [
        {
            "id": "1a4afe84cde07a0b9345cc29a878a7ec",
            "title": "Gunmen kill at least 29 at football pitch in north-east Nigeria, governor says",
            "description": "Attack in Adamawa state continues wave of violence across the country, including armed raid on orphanage in Kogi",
            "content": "Gunmen have killed at least 29 people in north-east Nigeria, a state governor said on Monday, with local people saying the attackers targeted young people gathered at a football pitch, the latest bout of deadly unrest in Africa’s most populous nation... [3495 chars]",
            "url": "https://www.theguardian.com/world/2026/apr/27/gunmen-kill-at-least-29-at-football-pitch-in-north-east-nigeria-governor-says",
            "image": "https://i.guim.co.uk/img/media/01f2eb7ca053a25d5513df0b96cb8a337dced345/125_0_3750_3000/master/3750.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=a66a2ff6c0920142893be2e283b72e84",
            "publishedAt": "2026-04-27T22:57:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "653b4792b0262cf33ef19cbec22f914c",
            "title": "Mali Rebels Strike Major Blow Against Junta and Russia’s Africa Corps",
            "description": "Coordinated attacks signified a major escalation of insurgent violence in a region of West Africa where military leaders had seized power and warmed to Moscow in recent years.",
            "content": "A rare joint offensive by Tuareg separatists and militants linked to Al Qaeda in Mali over the weekend represented a major setback for the West African country’s military regime and its Russian paramilitary partners.\nNo death toll has been confirmed ... [1306 chars]",
            "url": "https://www.nytimes.com/2026/04/27/world/africa/mali-jnim-violence-russia.html",
            "image": "https://static01.nyt.com/images/2026/04/27/multimedia/27int-mali-wtk-1-jbpt/27int-mali-wtk-1-jbpt-facebookJumbo.jpg",
            "publishedAt": "2026-04-27T21:35:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "941a476a340ee4f36b94887b46be32c7",
            "title": "Putin pledges support for Iran in talks with FM Araghchi",
            "description": "Russia's Vladimir Putin told Iran's Abbas Araghchi that Iranians would navigate the \"difficult period\" of war and he hoped for peace soon. Araghchi is visiting Russia at a time when talks with the US remain on hold.",
            "content": "Iranian Foreign Minister Abbas Araghchi on Monday met with Russian President Vladimir Putin in St. Petersburg, with the Russian president telling the Iranian diplomat that he hoped for peace soon.\nMoscow, an ally of Iran, has so far resisted being dr... [3466 chars]",
            "url": "https://www.dw.com/en/putin-pledges-support-for-iran-in-talks-with-fm-araghchi/a-76947020",
            "image": "https://static.dw.com/image/76955873_6.jpg",
            "publishedAt": "2026-04-27T20:34:49Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        }
    ]
}

Categories