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": 236282,
    "articles": [
        {
            "id": "158303d332a6dc33586c0d8e4c197a16",
            "title": "Pakistan strikes Kabul hours after Afghanistan attack on border troops",
            "description": "Escalation of violence between the volatile neighbours makes a Qatar-mediated ceasefire appear increasingly shaky",
            "content": "Pakistan carried out airstrikes in Kabul and two other Afghan provinces early Friday, Afghanistan’s government spokesperson said, hours after Afghanistan launched a cross-border attack on Pakistan in the latest escalation of violence between the vola... [3661 chars]",
            "url": "https://www.theguardian.com/world/2026/feb/27/afghanistan-pakistan-strikes-kabul",
            "image": "https://i.guim.co.uk/img/media/afb4a50c52cb51bc3fd814205c4c85dc7920cc91/805_0_4027_3222/master/4027.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=cc224691c9d513aea7f48a5b6bc07b14",
            "publishedAt": "2026-02-27T00:41:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "0c9aa36d92de3d4bf261692ecd1a7496",
            "title": "China's New Aircraft Carrier Looks Powerful - But It Has A Major Problem",
            "description": "China's naval capabilities have been expanding in recent years, but its newest aircraft carrier lags behind U.S. counterparts in some important ways.",
            "content": "On paper, China's latest aircraft carrier looks awesome. The Fujian was commissioned on the 5th of November, 2025, and is the third and most powerful addition to China's carrier fleet. Its introduction saw it crowned as the world's largest non-nuclea... [4363 chars]",
            "url": "https://www.slashgear.com/2107673/china-new-aircraft-carrier-major-problem/",
            "image": "https://www.slashgear.com/img/gallery/chinas-new-aircraft-carrier-looks-powerful-but-it-has-a-major-problem/l-intro-1771853486.jpg",
            "publishedAt": "2026-02-26T23:15:00Z",
            "lang": "en",
            "source": {
                "id": "1bb9f04fd13e8df526ed08e82c35e9df",
                "name": "SlashGear",
                "url": "https://www.slashgear.com"
            }
        },
        {
            "id": "6e5dbb02136df264485f53c8ee10f722",
            "title": "Vuelve la amenaza de la 'expropiación exprés' a través del nuevo decreto de emergencia económica",
            "description": "La Agencia Nacional de Tierras (ANT) se convertirá en una “policía administrativa” que podrá ocupar de manera, adquirir y hasta expropiar inmuebles.",
            "content": "La sombra de la ‘expropiación exprés’ revivió en los últimos días debido a uno de los nuevos decretos que el Gobierno expidió en el marco de la emergencia económica, el cual pretende restablecer los bienes de los damnificados por las inundaciones.\nLE... [3616 chars]",
            "url": "https://www.eltiempo.com/economia/sectores/vuelve-la-amenaza-de-la-expropiacion-expres-a-traves-del-nuevo-decreto-de-emergencia-economica-3535827",
            "image": "https://imagenes2.eltiempo.com/files/og_thumbnail/uploads/2026/02/25/699f389699af4.jpeg",
            "publishedAt": "2026-02-26T22:08:06Z",
            "lang": "es",
            "source": {
                "id": "58dd8560c9b69789426e2f65cf9472fd",
                "name": "ELTIEMPO.com",
                "url": "https://www.eltiempo.com"
            }
        }
    ]
}

Categories