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": 384584,
    "articles": [
        {
            "id": "146b767cf2257c1a981cde7dc04b6949",
            "title": "Taiwan attacker planned assault that killed 3 and injured 11, authorities say",
            "description": "Taiwanese authorities says the suspect who killed three people and injured 11 others in knife and smoke-grenade attacks in the island’s capital had planned the assaults and set fires at other locations earlier in the day",
            "content": "TAIPEI, Taiwan -- Taiwanese authorities said Saturday the suspect who killed three people and injured 11 others in knife and smoke-grenade attacks in the island's capital had planned the assaults and set fires at other locations earlier in the day.\nT... [2298 chars]",
            "url": "https://abcnews.go.com/International/wireStory/taiwan-attacker-planned-assault-killed-3-injured-11-128576755",
            "image": "https://i.abcnewsfe.com/a/3459f678-efea-42d9-8c58-14d00c9b50d0/wirestory_0a20a51658509a0ad4321cdd27f9ad73_16x9.jpg?w=1600",
            "publishedAt": "2025-12-20T06:15:24Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "ABC News",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "id": "0cf2ebe836c0bc7c51d33403178205e8",
            "title": "December 19, 2025 - Jeffrey Epstein files released",
            "description": "The Justice Department has released files tied to convicted sex offender Jeffrey Epstein.",
            "content": "The Justice Department released thousands of files related to sex offender and accused sex-trafficker Jeffrey Epstein.\nThe documents appears, at least after early reviews, to include no smoking guns and relatively few major revelations.\nHere are some... [14621 chars]",
            "url": "https://www.cnn.com/politics/live-news/jeffrey-epstein-files-released",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap24010058813245-20251112164933836.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-12-20T06:15:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "881fcad91c1b51b438f6f8858c684eae",
            "title": "Rob Reiner y Michele Singer: la recapitulación completa de uno de los asesinatos más escandalosos en la historia de Hollywood",
            "description": "Dolor e incredulidad ha generado este caso que mantiene en vilo a toda la industria del entretenimiento",
            "content": "La comunidad de Hollywood está conmociona tras el hallazgo sin vida del reconocido cineasta Rob Reiner y de su esposa Michele Singer, quienes fueron encontrados muertos el pasado domingo 14 de diciembre en su residencia de Brentwood, un exclusivo bar... [6025 chars]",
            "url": "https://www.infobae.com/entretenimiento/2025/12/20/rob-reiner-y-michele-singer-la-recapitulacion-completa-de-uno-de-los-asesinatos-mas-escandalosos-en-la-historia-de-hollywood/",
            "image": "https://www.infobae.com/resizer/v2/LFE65FV6F5AUBP7EBOCJEQBYQQ.jpg?auth=ebbe762023ab53aa8bcd0e6f2799fa1588a96788f1386e3bfc420e526d1ad9fd&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2025-12-20T06:00:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

Categories