Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 235742,
    "articles": [
        {
            "id": "a0be23482957d72b99ab7697844fa035",
            "title": "Radiografía de la guerra: así se comparan las pérdidas humanas de Rusia y Ucrania",
            "description": "Tras cuatro años de lucha, nuestro modelo revela un saldo sombrío",
            "content": "La “operación militar especial” de Vladimir Putin en Ucrania debía durar días. Cuatro años después, le ha costado caro a Rusia y ha obtenido escasos resultados. Las últimas estimaciones de bajas —de fuentes oficiales e independientes, así como de los... [2473 chars]",
            "url": "https://www.infobae.com/economist/2026/02/24/radiografia-de-la-guerra-asi-se-comparan-las-perdidas-humanas-de-rusia-y-ucrania/",
            "image": "https://www.infobae.com/resizer/v2/TKU2Y2XHGRB35KIAIETIWMM6LQ.jpg?auth=20d9186409ccdb9ba91d3fbb6c5397a9b9b3244c8fe7ebd9bb36f91c2ef2e528&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-02-24T23:09:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "2a5ca99bfac50503fc370a4f162a6076",
            "title": "Zelenskyy says Putin has 'not broken' Ukrainians on 4th anniversary of the war",
            "description": "Ukrainian President Volodymyr Zelenskyy says that Russia has not “broken Ukrainians” nor triumphed in its war.",
            "content": "KYIV, Ukraine (AP) — Ukrainian President Volodymyr Zelenskyy declared Tuesday that Russia has not “broken Ukrainians” nor triumphed in its war, four years after an invasion that has severely tested the resolve of Kyiv and its allies and fueled Europe... [7612 chars]",
            "url": "https://apnews.com/article/russia-ukraine-war-anniversary-87940e37c2f010572402640c8c5ac78c",
            "image": "https://dims.apnews.com/dims4/default/6845f7c/2147483647/strip/true/crop/7947x5295+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F7e%2F6a%2F0e48e428132bfb8c2e061d04536c%2F05ea685799ad4d23bafbeafc7263a476",
            "publishedAt": "2026-02-24T21:23:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "Associated Press News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "4af45aa0f80b00df5fabdd2e3fdf21d6",
            "title": "Louvre director resigns four months after shocking jewelry heist at the museum",
            "description": "The head of the Louvre Museum resigned Tuesday, four months after a brazen daylight heist where thieves snatched jewels worth approximately $102 million, shocking French citizens who questioned how a security breach of such magnitude could have taken place.",
            "content": "The head of the Louvre Museum resigned Tuesday, four months after a brazen daylight heist where thieves snatched jewels worth approximately $102 million, shocking French citizens who questioned how a security breach of such magnitude could have taken... [2024 chars]",
            "url": "https://www.nbcnews.com/world/europe/louvre-director-resigns-four-months-shocking-jewelry-heist-museum-rcna260508",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-02/260224-Louvre-gk-63891a.jpg",
            "publishedAt": "2026-02-24T21:21:03Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        }
    ]
}

Categories