United States News API

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

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 581568,
    "articles": [
        {
            "id": "fa483db89d11916c70c2769b00876ca9",
            "title": "Utah under historic ‘red flag’ weather warning amid dangerous wildfires",
            "description": "Governor also announced state of emergency and banned personal fireworks in state until after Fourth of July",
            "content": "Salt Lake City’s National Weather Service declared a “particularly dangerous situation red flag warning”, the first in the service’s history, according to a social media post.\n“THIS IS EXTREMELY RARE … Wind gusts of 40-50+ mph, combined with hot temp... [2239 chars]",
            "url": "https://www.theguardian.com/us-news/2026/jun/26/utah-governor-fireworks-wildfires",
            "image": "https://i.guim.co.uk/img/media/52433126a85aedb71a6bcb58f600a9af7f8da72c/464_0_4640_3712/master/4640.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=a0967669bf1b02894508978209698ec1",
            "publishedAt": "2026-06-27T00:49:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "b8758527b4fbc2f827448227875b5716",
            "title": "le 'regaló' el gol a España",
            "description": "El portero de la selección de Uruguay se volvió a equivocar y fue el responsable del primer tanto de España.",
            "content": "Fernando Muslera volvió a cometer un terrible error en el Mundial 2026. El portero de la selección uruguaya venía siendo muy señalado desde su fallo en el empate ante Cabo Verde (2-2) y esta noche volvió a quedar en el centro de las críticas contra E... [1327 chars]",
            "url": "https://www.diez.hn/mundial-2026-hoy/fernando-muslera-erro-gol-espana-uruguay-mundial-2026-PD31237239",
            "image": "https://www.diez.hn/binrepository/1201x901/0c0/1200d630/none/3014757/UQJS/untitled-design-1_14832339_20260626185651.jpg",
            "publishedAt": "2026-06-27T00:45:00Z",
            "lang": "es",
            "source": {
                "id": "62687b88e66412a58e4dbdec538ec187",
                "name": "Diez.hn",
                "url": "https://www.diez.hn"
            }
        },
        {
            "id": "c63a4c9221fbd112f538a5f1fa7050f3",
            "title": "Pete Buttigieg recalls ‘darkest hours’ after separation from children over hoax CPS report",
            "description": "Police say anonymous tip was unsubstantiated after what Buttigieg calls ‘deeply distressing’ day apart from children",
            "content": "Pete Buttigieg, the former US transportation secretary, said on Friday an anonymous and – police say – meritless accusation led Child Protective Services to investigate his family.\nIn a Substack post published on Friday, Buttigieg described the incid... [3215 chars]",
            "url": "https://www.theguardian.com/us-news/2026/jun/26/pete-buttigieg-cps-family-investigation-accusation",
            "image": "https://i.guim.co.uk/img/media/7e5f024e7c00a5457e5e848a8d8ba632f16eac0a/500_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=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=21baa52a062acec3aa6ffb21df660e45",
            "publishedAt": "2026-06-27T00:12:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

Categories