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": 234848,
    "articles": [
        {
            "id": "2b9af1056c6d5867d567bc1283a722e8",
            "title": "3 US troops killed and 5 are seriously wounded in Iran operation",
            "description": "Three U.S. service members have been killed and five others seriously wounded during the attacks on Iran.",
            "content": "WASHINGTON (AP) — Three American service members have been killed and five others seriously wounded during the U.S. attacks on Iran, the military announced Sunday, marking the first American casualties in a major offensive that President Donald Trump... [3991 chars]",
            "url": "https://apnews.com/article/iran-trump-us-military-troops-casualties-793c3ea29a399c9a405e70b14c548595",
            "image": "https://dims.apnews.com/dims4/default/138280d/2147483647/strip/true/crop/3786x2523+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F2d%2Fde%2F0009a308a4946a296d8aa5a4efd0%2F384fb2795f214aeea3de50ac4cb56a66",
            "publishedAt": "2026-03-02T00:37:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "1108513ece5b0b368e4f8d4aefaa4c9e",
            "title": "Excarcelaron al gendarme argentino Nahuel Gallo tras más de un año detenido",
            "description": "El gendarme argentino Nahuel Gallo fue excarcelado este domingo y ya se encuentra en vuelo hacia Argentina, según confirmó su esposa.",
            "content": "El gendarme argentino Nahuel Gallo fue excarcelado este domingo y ya se encuentra en vuelo hacia Argentina, según confirmó su esposa, María Alexandra Gómez, a través de un mensaje difundido en redes sociales.\n“Acabo de hablar con Nahuel Gallo y puedo... [1418 chars]",
            "url": "https://www.elnacional.com/2026/03/excarcelaron-al-gendarme-argentino-nahuel-gallo-tras-mas-de-un-ano-detenido/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2026/03/01184156/argentino-Nahuel-Gallo.jpg",
            "publishedAt": "2026-03-01T22:50:08Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        },
        {
            "id": "06996a9f65429439a7ce3acd2070397c",
            "title": "3 U.S. service members killed in military operation against Iran, CENTCOM says",
            "description": "U.S. Central Command said Sunday that three American service members were killed and five others were seriously wounded as part of the military operation in Iran.",
            "content": "U.S. Central Command said Sunday that three American service members were killed and five others were seriously wounded during Operation Epic Fury, the joint U.S.-Israeli military operation against Iran.\n\"Several others sustained minor shrapnel injur... [2137 chars]",
            "url": "https://www.cbsnews.com/news/iran-military-operation-american-service-members-killed-centcom/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/03/01/4f75f0b9-0a0b-4e6b-b27e-ef61abcc598c/thumbnail/1200x630/0462151e5179f355f9dd33b69268a32d/centcom-logo.jpg",
            "publishedAt": "2026-03-01T20:57:09Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories