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": 533380,
    "articles": [
        {
            "id": "8941b74b721114b7c65b192c70fe4737",
            "title": "Rep. Thomas Massie, Frequent Trump Critic, Is Ousted in Kentucky Primary",
            "description": "Mr. Massie, a Republican who frequently clashed with President Trump, lost to a Trump-backed challenger. The race was a closely watched test of the president’s power to punish his critics.",
            "content": "Hours earlier, the president’s endorsement of Ken Paxton in Texas was viewed as a hammer blow to Senator John Cornyn’s hopes of retaining his seat ahead of a runoff election next week.\nIn all, it was the latest evidence that even though Mr. Trump is ... [14699 chars]",
            "url": "https://www.nytimes.com/live/2026/05/19/us/midterms-georgia-kentucky",
            "image": "https://static01.nyt.com/images/2026/05/19/multimedia/19midterms-promo10p-pcmf/19midterms-promo10p-pcmf-facebookJumbo.jpg",
            "publishedAt": "2026-05-20T04:28:54Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "5d703d69057798b14f9e1984bc740b17",
            "title": "Xi Jinping and Vladimir Putin meet in Beijing less than a week after Trump visit",
            "description": "Coming so soon after the visit by US president Donald Trump, the optics and outcomes of the meeting between China and Russia will be closely scrutinised",
            "content": "Xi Jinping welcomed Russian president Vladimir Putin with pomp and pageantry as the pair kicked off talks in the Great Hall of the People on Wednesday morning, days after the Chinese leader hosted Donald Trump in the same location.\nChinese soldiers s... [2664 chars]",
            "url": "https://www.theguardian.com/world/2026/may/20/china-russia-xi-jinping-vladimir-putin-meet-beijing-after-trump-visit",
            "image": "https://i.guim.co.uk/img/media/165a8a9a184c1fe5265653645c5c145a0411c238/77_0_4583_3668/master/4583.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=9f8e5f913f7ef41638eef0c9c272601d",
            "publishedAt": "2026-05-20T03:51:12Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "64cc7d4870247ed3211c6c03f820ca3a",
            "title": "School board member who hugged teen and called her ‘hot’ is charged with assault",
            "description": "The charge stems from an incident on April 2, when Keith Ervin hugged the girl, a student member of the board, and told her, “God, you’re hot.”",
            "content": "A Tennessee school board member who hugged a teenage girl and called her “hot” at a public meeting last month has been charged with assault, court records show.\nThe charge of assault — physical contact stems from an incident on April 2, when Keith Er... [1945 chars]",
            "url": "https://www.nbcnews.com/news/us-news/school-board-member-hugged-teen-called-hot-charged-assault-rcna346023",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-04/260408-keith-ervin-ew-547p-194552.jpg",
            "publishedAt": "2026-05-20T03:26:00Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        }
    ]
}

Categories