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": 392776,
    "articles": [
        {
            "id": "16845e7db2a22bc7477c9fcefef50f2f",
            "title": "Thailand national election 2026: Voters head to the polls in high-stakes election",
            "description": "Thai voters will elect a new parliament and also vote on a referendum about the country's constitution.",
            "content": "Undergrad votes for equal education opportunities for all\nThanyarat Doksone\nProducer, BBC News Bangkok\nFirst-time voter Thanisorn Sitthisomboon, who is studying to to be a teacher, says she hopes Thai children can have access to more education opport... [11615 chars]",
            "url": "https://www.bbc.co.uk/news/live/c4g31zlezp1t",
            "image": "https://ichef.bbci.co.uk/ace/branded_news/1200/cpsprodpb/068a/live/b819d2c0-049e-11f1-93d2-a5ca46383603.jpg",
            "publishedAt": "2026-02-08T06:34:33Z",
            "lang": "en",
            "source": {
                "id": "da05009467a13bbcc84557ea09d86db3",
                "name": "BBC",
                "url": "https://www.bbc.co.uk"
            }
        },
        {
            "id": "0364a2af9b80d1d5810752e4100a524a",
            "title": "Andrei Arlovksi bludgeons Ben Rothwell in bloody BKFC heavyweight title fight at Knucklemania 6",
            "description": "Andrei Arlovski made it three in a row against Ben Rothwell, who was left battered, beaten and without a belt.",
            "content": "Andrei Arlovski, 47, won his trilogy fight with BKFC heavyweight champion Ben Rothwell on Saturday at the Xfinity Mobile Arena in Philadelphia.\nArlovski had fought Rothwell, 44, twice before, winning a decision and by knockout. And, this weekend, he ... [2964 chars]",
            "url": "https://sports.yahoo.com/mma/breaking-news/live/andrei-arlovksi-bludgeons-ben-rothwell-in-bloody-bkfc-heavyweight-title-fight-at-knucklemania-6-063037486.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/WdrW0dVtj0TF_Tgo5fXG7g--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://s.yimg.com/os/creatr-uploaded-images/2026-02/6c9c74b0-03db-11f1-b7bf-9407c80b9d84",
            "publishedAt": "2026-02-08T06:20:02Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        },
        {
            "id": "f6807b714bcc87279a8a3ce85ec3834b",
            "title": "Reaction to Trump’s Racist Post Shows He Is Not Always Immune to Politics",
            "description": "With the midterm elections nearing, President Trump has found himself in the uncomfortable position of backtracking, even if only by degrees, at key moments.",
            "content": "President Trump has seemed immune to the usual rules of politics.\nThe man who once boasted that he could “stand in the middle of Fifth Avenue and shoot somebody” without losing support from voters regularly shatters political and legal norms at home ... [2204 chars]",
            "url": "https://www.nytimes.com/2026/02/07/us/politics/trump-social-post-reaction.html",
            "image": "https://static01.nyt.com/images/2026/02/06/multimedia/07dc-trump/06trump-news-reporter-updates-mtfz-facebookJumbo-v2.jpg",
            "publishedAt": "2026-02-08T04:46:24Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories