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": 383374,
    "articles": [
        {
            "id": "5e981617a2d296b67d069b895108ff33",
            "title": "Bank of England cuts interest rates to 3.75%",
            "description": "The Bank's governor says interest rates are on a \"gradual\" downward path, and decisions around future cuts will be \"a closer call\".",
            "content": "Cut now, but what next for your finances?\nKevin Peachey\nCost of living correspondent\nIt doesn’t take long after one rates decision – a few minutes, in fact – before analysts wonder what it means for the next one.\nThat also has an impact on those abou... [9820 chars]",
            "url": "https://www.bbc.com/news/live/cn4d8p1gj2et",
            "image": "https://ichef.bbci.co.uk/ace/branded_news/1200/cpsprodpb/e1ef/live/f2a1a0e0-dbf3-11f0-b67b-690eb873de1b.jpg",
            "publishedAt": "2025-12-18T12:24:38Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "31df97e36c81fdd00aec4deddd6e3203",
            "title": "Saudi-backed forces gather on Yemen border as separatists face pressure to pull back",
            "description": "Southern Transitional Council, backed by UAE, told it could face airstrikes after its recent huge territorial gains",
            "content": "As many as 20,000 Saudi-backed forces are gathering on the border of Yemen as the separatist Southern Transitional Council comes under pressure to withdraw from the huge territorial gains it has made in the last month in the vast, oil-rich governorat... [4691 chars]",
            "url": "https://www.theguardian.com/world/2025/dec/18/saudi-backed-forces-yemen-border-separatists-stc",
            "image": "https://i.guim.co.uk/img/media/3b32ecc38242b8128db1d91fbf6f8daa7cdd6aec/1152_565_3872_3098/master/3872.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=68ca60637ff93a8b30c400a9beb232b6",
            "publishedAt": "2025-12-18T11:07:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "b9157195f58bcd0d29023cff0c894db2",
            "title": "Fact-checking Trump’s unusual new White House presidential plaques",
            "description": "Latest updates from the BBC's specialists in fact-checking, verifying video and tackling disinformation.",
            "content": "Trump inaccurately touts his peacemaking record on his presidential plaque\nJake Horton\nBBC Verify\nDonald Trump also added a plaque for his current term to the “Presidential Walk of Fame”, which includes exaggerated claims about his record in office s... [4788 chars]",
            "url": "https://www.bbc.com/news/live/cn7k8evp6k3t",
            "image": "https://static.files.bbci.co.uk/core/website/assets/static/news/images/metadata/poster-1024x576.5f404a8b8b.png",
            "publishedAt": "2025-12-18T11:03:45Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories