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": 499828,
    "articles": [
        {
            "id": "0a114da3330fe6a0bb3189f922f480c5",
            "title": "Crisis in space as Artemis II toilet breaks leaving astronauts with no other options",
            "description": "The toilet on board the Artemis II spacecraft has reportedly broken down again, leaving the four-member crew without a working alternative for nearly five days.",
            "content": "The toilet on board the Artemis II spacecraft has reportedly broken down again, leaving the four astronauts on board with no working bathroom on their return to Earth.\nAccording to a source speaking with the Daily Mail on Monday, the toilet on board ... [3696 chars]",
            "url": "https://www.dailymail.co.uk/sciencetech/article-15710785/artemis-ii-toilet-breaks-space-crisis.html",
            "image": "https://i.dailymail.co.uk/1s/2026/04/06/22/107694727-0-image-m-16_1775509765439.jpg",
            "publishedAt": "2026-04-06T21:16:54Z",
            "lang": "en",
            "source": {
                "id": "4aca9b1f6287a5f7a6dea911063bdb49",
                "name": "Daily Mail",
                "url": "https://www.dailymail.co.uk"
            }
        },
        {
            "id": "5433b4700208694b6ae8b3741ca139b1",
            "title": "TMZ’s Harvey Levin Believes New Nancy Guthrie Ransom Note Is Legit, Despite FBI Not Pursuing | Video",
            "description": "After a period of inactivity, Harvey Levin's TMZ received a new ransom note the morning Savannah Guthrie returned to host \"Today.\"",
            "content": "TMZ founder Harvey Levin revealed Monday that after a period of inactivity, the digital news site received a new ransom note claiming to have impactful information on Nancy Guthrie’s disappearance.\nThe anonymous sender, who has previously reached out... [2644 chars]",
            "url": "https://sg.news.yahoo.com/tmz-harvey-levin-believes-nancy-203907124.html",
            "image": "https://s.yimg.com/os/en/thewrap.com/681581951b3d4e21c6db71296ea5d603",
            "publishedAt": "2026-04-06T20:39:07Z",
            "lang": "en",
            "source": {
                "id": "d0f7288d14ec8c674636416b7d8b268b",
                "name": "Yahoo News Singapore",
                "url": "https://sg.news.yahoo.com"
            }
        },
        {
            "id": "2df0a92fde3ba95875371174a3a5c35b",
            "title": "Live updates: Artemis II astronauts break Apollo record on historic moon flyby",
            "description": "The NASA-led Artemis II mission, carrying a four-person crew beyond Earth orbit for the first time since 1972, is conducting a seven-hour flyby of the moon.",
            "content": "Lunar scientists have been buzzing about the topographical features of the moon’s surface that the astronauts will be able to glimpse with the naked eye — including spots along the moon’s right edge and the far side.\nBut there is one region of the mo... [13135 chars]",
            "url": "https://www.cnn.com/2026/04/06/science/live-news/nasa-artemis-2-flyby-moon-mission",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/art002e009212-large.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-04-06T20:32:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories