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": 410966,
    "articles": [
        {
            "id": "3022139a7886f2103ea7ef54ff204f36",
            "title": "Giannis seals Bucks' win over Lakers with block, steal vs. LeBron",
            "description": "Bucks star Giannis Antetokounmpo helped seal Milwaukee's 105-101 victory against the Lakers on Friday night with a pair of clutch defensive plays down the stretch against LeBron James.",
            "content": "LOS ANGELES -- Bucks star Giannis Antetokounmpo helped seal Milwaukee's 105-101 victory against the Los Angeles Lakers on Friday night with a pair of clutch defensive plays down the stretch against LeBron James.\nWith 39.2 seconds remaining and the sc... [2508 chars]",
            "url": "https://www.espn.com/nba/story/_/id/47567548/giannis-antetokounmpo-seals-bucks-win-vs-lakers-block-steal-lebron-james",
            "image": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0110%2Fr1598716_1296x729_16%2D9.jpg",
            "publishedAt": "2026-01-10T07:58:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "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": "110a43a2ddbd6d19f6e51484946f9e67",
            "title": "103 Kings (Jan 9, 2026) Game Recap",
            "description": "Expert recap and game analysis of the Golden State Warriors vs. Sacramento Kings NBA game from January 9, 2026 on ESPN.",
            "content": "SAN FRANCISCO -- — Stephen Curry had 27 points and a season-high 10 assists for his second double-double this season, and the Golden State Warriors beat the skidding Sacramento Kings 137-103 on Friday night.\nJimmy Butler added 15 points, six assists ... [1541 chars]",
            "url": "https://www.espn.com/nba/recap?gameId=401810394",
            "image": "http://s.espncdn.com/stitcher/sports/basketball/nba/events/401810394.png?templateId=espn.com.share.1",
            "publishedAt": "2026-01-10T05:50:46Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories