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": 196308,
    "articles": [
        {
            "id": "6777df088db38fe6afccc45188a1cc85",
            "title": "Trump’s territorial ambition: new imperialism or a case of the emperor’s new clothes?",
            "description": "Trump’s attack on Venezuela suggests expansionism is under way but some argue it is simply standard US foreign policy stripped of hypocrisy",
            "content": "The attack on Venezuela and the seizure of its president was a shocking enough start to 2026, but it was only the next day, when the smoke had dispersed and Donald Trump was flying from Florida to Washington DC in triumph, that it became clear the wo... [13940 chars]",
            "url": "https://www.theguardian.com/news/ng-interactive/2026/jan/10/trump-territorial-ambition-imperialism",
            "image": "https://i.guim.co.uk/img/media/15c0231fcf0bc936bb6246c17d3f006836ef4c58/134_11_4850_3881/master/4850.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=be06e11bf3c1a91d54b88fe254746dd3",
            "publishedAt": "2026-01-10T06:00:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "96b42bba2cdc56c97c13a6bcd9e24d71",
            "title": "World’s richest 1% have already used fair share of emissions for 2026, says Oxfam",
            "description": "Richest 1% took 10 days while wealthiest 0.1% needed just three days to exhaust annual carbon budget, study shows",
            "content": "The world’s richest 1% have used up their fair share of carbon emissions just 10 days into 2026, analysis has found.\nMeanwhile, the richest 0.1% took just three days to exhaust their annual carbon budget, according to the research by Oxfam.\nThe chari... [1754 chars]",
            "url": "https://www.theguardian.com/environment/2026/jan/10/world-richest-used-fair-share-emissions-2026-oxfam",
            "image": "https://i.guim.co.uk/img/media/e70fa53c0ba28296bd352289c81c82596a5824fa/55_0_2417_1933/master/2417.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=bd41567e98724b2710d4b3f81bd52da3",
            "publishedAt": "2026-01-10T05:00:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "04090ecfa631fbc04fd65d167c9cf4f1",
            "title": "La captura de Maduro dispara el apoyo a Trump entre venezolanos y cubanos: “Es un hombre de palabra”",
            "description": "Mientras la mayoría de los estadounidenses desaprueba la captura del presidente de Venezuela, entre estos dos exilios ha crecido la admiración y agradecimiento hacia el republicano",
            "content": "Habría que hacerle una estatua a Donald Trump justo al lado de la de Simón Bolívar en la plaza del centro histórico de Caracas, donde todo el que pase recuerde que a Venezuela primero la liberó un venezolano y luego un estadounidense. Carlos Muñoz, u... [8812 chars]",
            "url": "https://elpais.com/us/migracion/2026-01-10/la-captura-de-maduro-dispara-el-apoyo-a-trump-entre-venezolanos-y-cubanos-es-un-hombre-de-palabra.html",
            "image": "https://imagenes.elpais.com/resizer/v2/BBZVCK7D55AZZFR3N3AD6F56DQ.jpg?auth=756341fe0b1dd01368428b49183b34a8b66df232856a53ee66d6ae2c6c84be27&width=1200",
            "publishedAt": "2026-01-10T04:30:00Z",
            "lang": "es",
            "source": {
                "id": "eb1bfc7349a10fd1bd06d9ecfaa8b438",
                "name": "EL PAÍS",
                "url": "https://elpais.com"
            }
        }
    ]
}

Categories