United States Nation News API

Get the live top nation headlines from United States with our JSON API.

Get API key for the United States Nation 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=nation&apikey=API_KEY
{
    "totalArticles": 561620,
    "articles": [
        {
            "id": "09d6a2f7a944960618fc3c8eb02a2926",
            "title": "Eight children killed in Louisiana shooting, police say",
            "description": "The children, aged from one to 14 years old, were killed in a shooting that police are describing as a \"domestic disturbance\".",
            "content": "Man kills seven of his children, and an eighth child, in Louisiana mass shooting\nA father has killed seven of his children and an unrelated child in a mass shooting in Shreveport in the US state of Louisiana that police have described as a \"domestic ... [2863 chars]",
            "url": "https://www.bbc.com/news/articles/c0q9v1p2dd2o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/72b1/live/b4ab8540-3c3c-11f1-a902-531b59555add.jpg",
            "publishedAt": "2026-04-20T04:10:40Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "4bf03df01d8a6bbc7b85feb1e2da4fcf",
            "title": "Middle East crisis live: ceasefire under pressure and talks in doubt as Iran threatens to ‘retaliate’ to US seizure of ship",
            "description": "Donald Trump said on Sunday that US marines had taken custody of a vessel that tried to get past the American blockade on Iranian ports",
            "content": "Key events\nShow key events only\nPlease turn on JavaScript to use this feature\nIran’s Mizan news outlet is reporting that Iran has executed two individuals accused of involvement in a “spy network linked to Israel”.\nMizan claimed the two men were accu... [10089 chars]",
            "url": "https://www.theguardian.com/world/live/2026/apr/20/iran-war-latest-news-updates-live-hormuz-trump-us-iranian-ship-ceasefire-doubt",
            "image": "https://i.guim.co.uk/img/media/38ea08a8aadf4ad42de7840df22c917da498005a/658_0_5000_4000/master/5000.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=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=089fbbd331c4577ea72b210ad23c277d",
            "publishedAt": "2026-04-20T04:09:59Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "380e28ff294dc217dd0607e7a8b021bd",
            "title": "Descubrimiento histórico: encuentran el mayor yacimiento de tierras raras valorado en 64.000 millones de euros",
            "description": "El descubrimiento de este yacimiento representa un posible punto de inflexión para el suministro de tierras raras de Europa",
            "content": "Un hallazgo realizado en el norte de Europa durante 2023 despertó el interés de empresas, autoridades y organismos financieros. Se trataba del mayor yacimiento de tierras raras encontrado hasta la fecha en Europa, anunciado por una compañía con más d... [5012 chars]",
            "url": "https://okdiario.com/ciencia/descubrimiento-yacimientos-tierras-raras-valorado-mas-64-000-millones-euros-que-nadie-esperaba-14612359",
            "image": "https://okdiario.com/img/2025/04/14/explotacion-minera.jpg",
            "publishedAt": "2026-04-20T03:27:28Z",
            "lang": "es",
            "source": {
                "id": "1d09b1e42f599e88d21bdf76817c6406",
                "name": "OkDiario",
                "url": "https://okdiario.com"
            }
        }
    ]
}

Categories