Flag of the 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": 6973528,
    "articles": [
        {
            "id": "3349fee2197936a0b472aa728c8a09eb",
            "title": "The return of the spoof: can comedy’s silliest subgenre make a comeback?",
            "description": "The Naked Gun returns this weekend hoping to relaunch a long-dormant subgenre with Scary Movie, Spinal Tap and Spaceballs sequels to follow",
            "content": "The Naked Gun, a sequel/reboot to the old movie series of the same name, represents the first of its kind in a long time. No, not a legacy sequel, nor a Liam Neeson movie; the in-demand Irish actor still does two or three of those a year. Like its pr... [7901 chars]",
            "url": "https://www.theguardian.com/film/2025/jul/31/the-return-of-the-spoof",
            "image": "https://i.guim.co.uk/img/media/da7ff52c3d4fabbabb07f1ec00f37056e3a1ccae/481_0_5143_4115/master/5143.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=5de9afb8025d7268a23cd52e82e5ec35",
            "publishedAt": "2025-07-31T09:13:00Z",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "b5b9c65476a18e3db83f8e17f9f5f8d2",
            "title": "Verifying drone and missile strikes in Ukraine",
            "description": "Latest updates from the BBC's specialists in fact-checking, verifying video and tackling disinformation.",
            "content": "Footage shows Russian flags raised in Chasiv Yar\nPaul Brown\nBBC Verify senior journalist\nImage source, Telegram\nRussia's defence ministry has announced the capture of Chasiv Yar in Ukraine's Donetsk region, after well over a year of fighting.\nThe cla... [899 chars]",
            "url": "https://www.bbc.com/news/live/ce35ly75ppkt",
            "image": "https://ichef.bbci.co.uk/ace/branded_news/1200/cpsprodpb/6737/live/e478f290-6de7-11f0-89ea-4d6f9851f623.png",
            "publishedAt": "2025-07-31T08:37:01Z",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "674ed7d3794fc18a2b53a263aba687b6",
            "title": "Lawyers warn Starmer recognising Palestinian state could break international law",
            "description": "Sir Keir Starmer says the UK will recognise a Palestinian state in September if conditions are not met.",
            "content": "Lawyers warn Starmer recognising Palestinian state could break law\n44 minutes ago Share Save Jennifer McKiernan • @_JennyMcKiernan Political reporter, BBC News Henry Zeffman • @hzeffman Chief Political Correspondent Share Save\nPA Media\nSome of Britai... [5254 chars]",
            "url": "https://www.bbc.com/news/articles/c78z69x61e6o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/df42/live/fe8a8f70-6de4-11f0-a892-515a56809149.png",
            "publishedAt": "2025-07-31T08:25:11Z",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}                        

Categories