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": 563010,
    "articles": [
        {
            "id": "23ac31e4a52703908c96e89439e37377",
            "title": "Honduras pierde ante Argentina en el segundo partido de José Molina",
            "description": "El Honduras vs Argentina se disputó en el Kyle Field Stadium de la ciudad de College Station, Texas ante la presencia de más de 91 mil aficionados.",
            "content": "La selección de Argentina derrotó por marcador de 2-0 a Honduras, el sábado 6 de junio, en partido amistoso internacional disputado en el Kyle Field Stadium de College Station, Texas.\nAnte un aforo de más de 80 mil personas, en un estadio de 102 espe... [2134 chars]",
            "url": "https://www.deportestvc.com/seleccion-honduras/honduras-vs-argentina-en-vivo-hoy-donde-ver-partido-2026-06-06",
            "image": "https://www.deportestvc.com/wp-content/uploads/2026/06/hondurasvsargentina_principal-envivo-1.jpg",
            "publishedAt": "2026-06-07T03:33:45Z",
            "lang": "es",
            "source": {
                "id": "b2d262ac81376931ce3bdac5d0b90c78",
                "name": "Deportes TVC",
                "url": "https://www.deportestvc.com"
            }
        },
        {
            "id": "355728aaa9e17ee216d8e3f9d7a4fb2c",
            "title": "Hideo Kojima Says He's No Longer Interested In AI",
            "description": "The Death Stranding 2 director recently appeared in an AI-generated promo for a new art exhibit",
            "content": "Last month, a generative AI version of Death Stranding 2 director Hideo Kojima appeared in a short promotional movie for a Prada art installation revolving around the famed game developer and movie director Nicolas Winding Refn, who also appeared at ... [1800 chars]",
            "url": "https://kotaku.com/hideo-kojima-says-hes-not-interested-in-ai-maybe-ai-could-create-art-but-while-i-live-i-dont-think-ill-see-it-2000703473",
            "image": "https://kotaku.com/app/uploads/2026/06/Kojima-1200x675.jpg",
            "publishedAt": "2026-06-07T02:41:33Z",
            "lang": "en",
            "source": {
                "id": "7644d33b32ee6c65e94907ddf3d33119",
                "name": "Kotaku",
                "url": "https://kotaku.com"
            }
        },
        {
            "id": "59bb84bbc881ff8547637a0fd3c4e0a9",
            "title": "Pratt's lead over Raman further erodes in new L.A. mayoral race results as voters await California governor's race news",
            "description": "Political newcomer Spencer Pratt's lead over Los Angeles City Councilwoman Nithya Raman in the race for L.A. mayor has continued to diminish since election night.",
            "content": "Outcomes in California's two most closely watched primaries for governor and Los Angeles mayor remained unresolved Saturday evening, but new results saw the mayoral race tighten significantly as voters await who will advance to the November election ... [4880 chars]",
            "url": "https://www.cbsnews.com/losangeles/news/california-governor-la-mayor-results-hilton-steyer-pratt-raman/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/06/06/68e2c878-326c-4557-9c1c-d349716e880e/thumbnail/1200x630/d37a331ae19469209495e879ffc42027/copy-of-generic-youtube-thumbnail-no-gradient-2026-06-06t095226-249.jpg",
            "publishedAt": "2026-06-07T00:56:51Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories