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": 251552,
    "articles": [
        {
            "id": "7d20efff61d315e89d75c63f39fda0e3",
            "title": "UK 'investigating' after yacht says Russian warship fired 'warning shots' in Channel",
            "description": "The incident comes two days after armed British forces boarded and detained a sanctioned tanker in the Channel that is suspected of being part of Russia’s shadow fleet.",
            "content": "Britain's defence ministry said on Tuesday it was \"investigating reports of an incident in the Channel,\" as a UK defence source told the AFP news agency that a yacht had reported a Russian warship firing warning shots.\nThe incident apparently took pl... [2038 chars]",
            "url": "https://www.euronews.com/my-europe/2026/06/16/russian-warship-fires-shots-at-vessel-in-english-channel-uk-media-say",
            "image": "https://images.euronews.com/articles/stories/09/80/10/06/1200x675_cmsv2_40dc1dc7-af08-5369-8d95-34ad08601d54-9801006.jpg",
            "publishedAt": "2026-06-16T15:37:42Z",
            "lang": "en",
            "source": {
                "id": "fe7887ab38dfaf6c0f8af3a124d38295",
                "name": "Euronews",
                "url": "https://www.euronews.com"
            }
        },
        {
            "id": "d8b2b0e0a55d8330b6db5d42730839e7",
            "title": "El artista ruso crítico de Putin que fue asesinado a tiros en Polonia",
            "description": "Robert Kuzovkov, quien utilizaba el seudónimo de Semyon Skrepetsky, era conocido por sus caricaturas de políticos, incluido Vladimir Putin.",
            "content": "Autor, Adam Easton\nTítulo del autor, Corresponsal en Varsovia\nFecha de publicación 2 horas\nTiempo de lectura: 2 min\nLa policía de Polonia investiga el asesinato de un artista ruso crítico con el presidente Vladimir Putin.\nLa fiscalía polaca informó q... [2154 chars]",
            "url": "https://www.bbc.com/mundo/articles/c621grznlg4o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/8b7c/live/dca92700-6996-11f1-9685-4f5a66750059.jpg",
            "publishedAt": "2026-06-16T15:07:57Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "236e03fffae359088c659541ec5487ff",
            "title": "Trump hints US could resume oil sanctions on Russia as G7 ups pressure on Kremlin",
            "description": "Leaders are using the summit to kickstart efforts to end the war in Ukraine.",
            "content": "EVIAN-LES-BAINS, France — U.S. President Donald Trump said Tuesday that Washington could reinstate sanctions on Russian oil as part of a renewed pressure campaign against the Kremlin by the G7 leading economies.\nThe U.S. had suspended sanctions on Ru... [2178 chars]",
            "url": "https://www.politico.eu/article/g7-pressure-russia-ukraine-war-oil-sanctions-donald-trump/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2026/06/16/GettyImages-2281269449-scaled.jpg",
            "publishedAt": "2026-06-16T14:21:19Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu"
            }
        }
    ]
}

Categories