Flag of United States

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": 415286,
    "articles": [
        {
            "id": "26f67a35ece3bf03fbf672371080408e",
            "title": "Ndiaga Diagne named as suspect",
            "description": "Three people are dead and 14 others were injured in a mass shooting early Sunday outside Buford’s bar on West Sixth Street.",
            "content": "Federal officials have identified Ndiaga Diagne as the suspect in the mass shooting that left three people dead, including Diagne, and 14 others injured Sunday morning outside of Buford's bar on West Sixth Street in downtown Austin. Diagne has been a... [9115 chars]",
            "url": "https://www.statesman.com/news/local/article/bufords-austin-6th-street-shooting-21948608.php",
            "image": "https://s.hdnux.com/photos/01/63/43/13/30290658/3/rawImage.jpg",
            "publishedAt": "2026-03-01T20:24:37Z",
            "lang": "en",
            "source": {
                "id": "2baebf2efec2c61d01912c4ca7a8a5de",
                "name": "Austin American-Statesman",
                "url": "https://www.statesman.com"
            }
        },
        {
            "id": "d80af2b1b81cd63ea0448107dfeb1842",
            "title": "U.S.-Israeli strikes in Iran continue into 2nd day : NPR",
            "description": "The deaths of three U.S. servicemen mark the first American casualties since the start of operation \"Epic Fury\" on Saturday.",
            "content": "AMMAN, Jordan and WASHINGTON — Three U.S. service members were killed and at least five seriously wounded in the war against Iran, U.S. Central Command (CENTCOM) said Sunday — the first American casualties since the United States and Israel launched ... [7055 chars]",
            "url": "https://www.npr.org/2026/03/01/nx-s1-5731365/us-israeli-strikes-region",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/1024x576+0+54/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F88%2Fe1%2Fc174f66e4d8f9fffe55dea47954f%2Fgettyimages-2263658977.jpg",
            "publishedAt": "2026-03-01T19:48:00Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "52d2642ee29c4a6a5f64603eece9efef",
            "title": "US military reportedly used Claude in Iran strikes despite Trump’s ban",
            "description": "Trump calls Anthropic a ‘Radical Left AI company run by people who have no idea what the real World is all about’",
            "content": "The US military reportedly used Claude, Anthropic’s AI model, to inform its attack on Iran despite Donald Trump’s decision, announced hours earlier, to sever all ties with the company and its artificial intelligence tools.\nThe use of Claude during th... [1978 chars]",
            "url": "https://www.theguardian.com/technology/2026/mar/01/claude-anthropic-iran-strikes-us-military",
            "image": "https://i.guim.co.uk/img/media/6c7873490cf4f46df61186b00b7a8683dd0fff34/971_0_6632_5304/master/6632.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=9e2c96113df96546c551188b31aae76c",
            "publishedAt": "2026-03-01T18:52:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

Categories