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": 555062,
    "articles": [
        {
            "id": "96a833a4f7265a1c4f7c559656d33bc2",
            "title": "‘It’s getting hotter and it’s not stopping’: dealing with the heat in five of Europe’s capitals",
            "description": "Tourists and locals in Madrid, Paris, London, Dublin and Berlin share their experiences of the unseasonable May temperatures",
            "content": "In recent days across parts of Europe, temperatures have soared, heat records have been broken and spring has felt more like the height of summer. Météo France, the French national weather service, has attributed this to a “heat dome”, with warmth he... [10481 chars]",
            "url": "https://www.theguardian.com/environment/2026/may/27/its-getting-hotter-and-its-not-stopping-dealing-with-the-heat-in-five-of-europes-capitals",
            "image": "https://i.guim.co.uk/img/media/2168e48f65db8807d0cc71ca8f61f64adfb9b2a5/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=d3ea412bb28c03bd6596f908b6badf91",
            "publishedAt": "2026-05-28T01:31:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "2433e8a611ecdcf1a7c95f2303d7dc2e",
            "title": "Trump Says He Feels No Political Pressure to Make an Iran Deal",
            "description": "President Trump held out hope for a peace agreement, but said high oil prices would not force his hand.",
            "content": "President Trump on Wednesday held the door open for more negotiations with Iran but insisted he did not feel any political pressure to make a deal to end the unpopular three-month war and lower gas prices.\nHe rejected any suggestion that the looming ... [1039 chars]",
            "url": "https://www.nytimes.com/2026/05/27/world/middleeast/trump-iran-peace-talks.html",
            "image": "https://static01.nyt.com/images/2026/05/27/multimedia/27int-iran-ledeall-photo-tpvm/27int-iran-ledeall-photo-tpvm-facebookJumbo.jpg",
            "publishedAt": "2026-05-28T00:58:48Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "0d26c4e96db4fda10d4c77402cd02ba7",
            "title": "US government official arrested after $40 million in gold bars found in home",
            "description": "Agents also found about $2 million in cash and 35 luxury watches in the home of David Rush, who court filings say had top secret clearance.",
            "content": "A former US government official has been arrested after FBI investigators found hundreds of gold bars worth more than $40 million (£29.6 million) in his Virginia home.\nDavid Rush made several requests to the US government to receive the bars for \"wor... [2111 chars]",
            "url": "https://www.bbc.com/news/articles/c5yezdl054po",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/0416/live/ec88a690-5a2e-11f1-b347-d1659dddfca0.jpg",
            "publishedAt": "2026-05-28T00:58:42Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories