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": 364792,
    "articles": [
        {
            "id": "abcec4db2dee858ba3cf728c63fe256b",
            "title": "After ‘good’ Trump meeting, Zelensky pushes Europe hard to do more",
            "description": "Trump and White House envoy Witkoff have said a deal to resolve nearly four years of war between Russia and Ukraine is close.",
            "content": "Trump and his envoy Steve Witkoff have said a deal to resolve nearly four years of war between Russia and Ukraine is close.\nUpdated\nJanuary 22, 2026 at 12:11 p.m. EST1 minute ago\nKYIV — Ukrainian President Volodymyr Zelensky aimed a blistering speech... [271 chars]",
            "url": "https://www.washingtonpost.com/world/2026/01/22/trump-zelensky-davos-ukraine-russia/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/AH5HN4TR7DGJ5LGF2X7OZEKVP4_size-normalized.jpg&w=1440",
            "publishedAt": "2026-01-22T18:05:01Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "2ee91084497a794a87a180c54ffe47e4",
            "title": "Protester Nekima Levy Armstrong Who Interrupted Minnesota Church Service Is Arrested, Officials Say",
            "description": "A standoff between demonstrators and congregants at Cities Church in St. Paul, Minn. on Sunday added to tensions around federal immigration enforcement in the state.",
            "content": "The Justice Department said on Thursday that it had arrested at least two of the demonstrators involved in interrupting a church service in St. Paul, Minn., to protest a pastor’s apparent work as an Immigration and Customs Enforcement official.\nAttor... [2274 chars]",
            "url": "https://www.nytimes.com/2026/01/22/us/nekima-levy-armstrong-arrest-minnesota-church.html",
            "image": "https://static01.nyt.com/images/2026/01/21/multimedia/21nat-minn-church-wbmj/21nat-minn-church-wbmj-facebookJumbo.jpg",
            "publishedAt": "2026-01-22T17:43:15Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "a237a33bde26fd8a6247dd42c9187c80",
            "title": "Harry Styles Announces 2026 Tour Dates",
            "description": "Harry Styles has announced dates for his hotly anticipated tour in support of his forthcoming fourth solo album 'Kiss All the Time. Disco, Occasionally.'",
            "content": "Harry Styles has announced dates for his hotly anticipated tour in support of his forthcoming fourth solo album with the intriguingly punctuated title of “Kiss All the Time. Disco, Occasionally.”\nThe dates, a series of residences in seven cities acro... [6702 chars]",
            "url": "https://variety.com/2026/music/news/harry-styles-2026-tour-dates-1236638023/",
            "image": "https://variety.com/wp-content/uploads/2023/07/Harry-Styles.jpg?w=1000&h=563&crop=1",
            "publishedAt": "2026-01-22T17:06:00Z",
            "lang": "en",
            "source": {
                "id": "c96d85bc8a846b5845a5420fe892ac16",
                "name": "Variety",
                "url": "https://variety.com"
            }
        }
    ]
}

Categories