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": 388618,
    "articles": [
        {
            "id": "ccc0fc2496d54b72ddc0fd97e78ce62d",
            "title": "Trimble’s last-second 3 gives UNC victory over rival Duke",
            "description": "The Tar Heels didn't lead all game until Trimble's 3-pointer with 0.4 seconds remaining.",
            "content": "CHAPEL HILL — North Carolina senior Seth Trimble forever secured his place in the Duke-UNC rivalry.\nTrimble’s 3-pointer from the corner with 0.4 seconds remaining gave the 14th-ranked Tar Heels their first – and only – lead of the game in a 71-68 vic... [751 chars]",
            "url": "https://www.wral.com/sports/duke-north-carolina-mens-basketball-meeting-in-chapel-hill-february-2026/",
            "image": "https://images.wral.com/4c89ee86-66c5-498e-b6e1-321712d82eef?w=1200&h=630",
            "publishedAt": "2026-02-08T01:41:15Z",
            "lang": "en",
            "source": {
                "id": "c9997f2398961754a61e4146d00b3652",
                "name": "wral.com",
                "url": "https://www.wral.com"
            }
        },
        {
            "id": "a8d71248bf0abcf2711a3dc77d25cb2d",
            "title": "Whistle-Blower Report Involved Intelligence About a Trump Contact",
            "description": "Tulsi Gabbard, the director of national intelligence, moved to lock down an intelligence intercept that referred to someone close to President Trump, the report said.",
            "content": "Members of Congress were briefed this week on a whistle-blower report about an intelligence intercept of a call between two foreign nationals discussing a person close to President Trump, according to people familiar with the material.\nIt is not clea... [1350 chars]",
            "url": "https://www.nytimes.com/2026/02/07/us/politics/whistle-blower-gabbard-trump.html",
            "image": "https://static01.nyt.com/images/2026/02/07/multimedia/07dc-intel-zfqj/07dc-intel-zfqj-facebookJumbo.jpg",
            "publishedAt": "2026-02-08T01:19:47Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "e4be12620dce5f6c993c699b5620abf0",
            "title": "Thailand election: 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": "The role of the senate\nThailand's senate - the parliament's upper house that's dominated by conservatives - cast a shadow over the country's last election in 2023.\nThe then Move Forward Party (whose latest incarnation is the People's Party) had won t... [7754 chars]",
            "url": "https://www.bbc.com/news/live/c4g31zlezp1t",
            "image": "https://ichef.bbci.co.uk/ace/branded_news/1200/cpsprodpb/b1a1/live/39ca7890-026c-11f1-b5e2-dd58fc65f0f6.jpg",
            "publishedAt": "2026-02-08T00:50:40Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories