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": 232182,
    "articles": [
        {
            "id": "320a8a07d16db87fcf32c87b581e4a46",
            "title": "Russian attack on Ukraine’s Kyiv kills 12-year-old child, wounds 10",
            "description": "Kyiv’s mayor says the attacks hit Podilskyi and Obolonsky districts, causing fires and damage to residential buildings.",
            "content": "Russian forces have bombed the Ukrainian capital Kyiv, killing a 12-year-old child and wounding at least 10 people, including several medics, according to the city’s mayor.\nThe child was killed early on Thursday in Kyiv’s Podilskyi district, where ro... [1497 chars]",
            "url": "https://www.aljazeera.com/news/2026/4/16/russian-attack-on-ukraines-kyiv-kills-12-year-old-child-wounds-10",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/04/2026-04-15T183333Z_555762142_RC2TPKANWNFQ_RTRMADP_3_UKRAINE-CRISIS-ATTACK-KYIV-1776303661.jpg?resize=1920%2C1440",
            "publishedAt": "2026-04-16T01:09:04Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "62474cd7025a2a8dc067f23fe844a302",
            "title": "Trump’s Portrayal of the War in Iran Collides With Reality",
            "description": "President Trump is confronting a crisis that is not bending to his narrative of a “pretty reasonable” new regime in Iran and all-but-assured victory for the United States.",
            "content": "President Trump is trying to cast his Iran war as all but over, a done-and-dusted success.\nBut after years of trying to impose his own reality on the world, he has now run into a crisis that is not bending to his narrative.\n“It’s a new regime,” Mr. T... [1916 chars]",
            "url": "https://www.nytimes.com/2026/04/15/us/politics/trump-iran-war.html",
            "image": "https://static01.nyt.com/images/2026/04/15/multimedia/15DC-PREXY-mftq/15DC-PREXY-mftq-facebookJumbo.jpg",
            "publishedAt": "2026-04-15T22:26:55Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "4ed875e652c4ff79f2c39e07b5b07c92",
            "title": "Una joven de 19 años muere tras ser atacada por la perra de su familia en Reino Unido",
            "description": "El animal era considerado afectuoso y sin antecedentes de agresividad.",
            "content": "Una joven de 19 años falleció luego de ser atacada por la perra de su familia dentro de su vivienda en la localidad de Leaden Roding, en Essex, Reino Unido. El hecho generó impacto por tratarse de un animal considerado dócil.\nLa víctima fue identific... [1635 chars]",
            "url": "https://www.primerahora.com/noticias/mundo/notas/una-joven-de-19-anos-muere-tras-ser-atacada-por-la-perra-de-su-familia-en-reino-unido/",
            "image": "https://www.primerahora.com/resizer/v2/GMTY6FYZABAPLLJ34BMM23CUN4.jpg?auth=f061d9e314484464c39a0831fdfa4c3454eef95503a73d25b8a1f1645594d089&quality=75&width=1200&height=717&focal=279%2C184",
            "publishedAt": "2026-04-15T22:06:36Z",
            "lang": "es",
            "source": {
                "id": "0ff9d9aa3439f245d940177440bfe1dd",
                "name": "Primera Hora",
                "url": "https://www.primerahora.com"
            }
        }
    ]
}

Categories