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": 487598,
    "articles": [
        {
            "id": "a7e2948504a85e7abce233a7c65d4b34",
            "title": "'Buffy the Vampire Slayer' Star Was 54",
            "description": "Nicholas Brendon, who played Xander Harris on \"Buffy the Vampire Slayer,\" died in his sleep Friday, according to a statement. He was 54.",
            "content": "Nicholas Brendon, who played Xander Harris on “Buffy the Vampire Slayer” and Kevin Lynch on “Criminal Minds,” died in his sleep Friday, according to a statement from his family. He was 54.\nThe statement from his family read, “We are heartbroken to sh... [2882 chars]",
            "url": "https://variety.com/2026/tv/news/nicholas-brendon-dead-buffy-the-vampire-slayer-1236695741/",
            "image": "https://variety.com/wp-content/uploads/2025/02/Nicholas-Brendon.jpg?w=1000&h=563&crop=1",
            "publishedAt": "2026-03-21T01:27:00Z",
            "lang": "en",
            "source": {
                "id": "c96d85bc8a846b5845a5420fe892ac16",
                "name": "Variety",
                "url": "https://variety.com"
            }
        },
        {
            "id": "3d1419f203d54cc816f774a1b3810c27",
            "title": "Dow Jones Jumps Late After Sell-Off As Trump Mulls 'Winding Down' Iran War",
            "description": "The Dow Jones, S&P 500 and Nasdaq broke lower as oil prices and yields soar. But Trump then said he's mulling \"winding down\" the Iran war.",
            "content": "Information in Investor’s Business Daily is for informational and educational purposes only and should not be construed as an offer, recommendation, solicitation, or rating to buy or sell securities. The information has been obtained from sources we ... [1013 chars]",
            "url": "https://www.investors.com/market-trend/stock-market-today/dow-jones-futures-oil-prices-yields-trump-iran-war-winding-down/",
            "image": "https://www.investors.com/wp-content/uploads/2025/03/Stock-Trumplookingright-02-shutt.jpg",
            "publishedAt": "2026-03-21T00:43:19Z",
            "lang": "en",
            "source": {
                "id": "b5fd7d235a4765231123b8f22bcf428a",
                "name": "Investor's Business Daily",
                "url": "https://www.investors.com"
            }
        },
        {
            "id": "65660f6e6f74eb3c295272193ee85d18",
            "title": "Fresno Took 30 Years to Name Cesar Chavez Blvd. Undoing It Took a Day.",
            "description": "The reckoning for the labor leader’s sex abuse was swift in Fresno, Calif., the heart of the Central Valley region where the farmworker movement was born. Towns across the nation face similar debates.",
            "content": "For 30 years, Latino farmworkers in Fresno, Calif., watched as other cities named streets in honor of Cesar Chavez. San Francisco, Los Angeles and Austin, Texas, swiftly paid tribute not long after his death in 1993. The state of California made Cesa... [1256 chars]",
            "url": "https://www.nytimes.com/2026/03/20/us/fresno-cesar-chavez-street-rename.html",
            "image": "https://static01.nyt.com/images/2026/03/20/multimedia/20nat-chavez-fresno-ckzf/20nat-chavez-fresno-ckzf-facebookJumbo.jpg",
            "publishedAt": "2026-03-21T00:05:56Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories