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": 244362,
    "articles": [
        {
            "id": "3f800e69f3aa48ebee7d1920ed394cbd",
            "title": "Six vessels attacked amid reports of Iranian drone boats, sea mines",
            "description": "Iraq reportedly suspends oil terminal operations after two tankers hit by explosive-laden boats in Iraqi waters.",
            "content": "Iranian explosive-laden boats appear to have attacked two fuel tankers in Iraqi waters, setting them ablaze and killing one crew member, after projectiles struck four vessels in Gulf waters, according to reports.\nThe ships targeted in late-night ⁠att... [4986 chars]",
            "url": "https://www.aljazeera.com/news/2026/3/12/five-vessels-attacked-amid-reports-of-iranian-drone-boats-sea-mines",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/03/AFP__20260311__A2T34NR__v5__HighRes__WarIranUsIsraelThailandAttackLogistics-1773284194.jpg?resize=1920%2C1440",
            "publishedAt": "2026-03-12T08:15:00Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "23d0b10317b0b8803a8d3ec3787c97a9",
            "title": "LIVE UPDATES: Cargo ship struck in Strait of Hormuz as Iran launches drone, missile attacks",
            "description": "A cargo ship was struck on Wednesday by a projectile in the Strait of Hormuz, setting it ablaze after the U.S. targeted Iranian minelaying vessels that could target the strait. Iran is continuing to launch attacks on neighboring countries in the region in response to American military action.",
            "content": "1 hour ago\nPinned\nContainer ship struck by projectile 40 miles off Dubai, British military says\nThe United Kingdom Maritime Trade Operations (UKMTO) said a container ship was struck by an \"unknown projectile\" 35 nautical miles northwest of Dubai and ... [45441 chars]",
            "url": "https://www.foxnews.com/live-news/us-iran-israel-war-latest-march-11-live-updates",
            "image": "https://assets.foxnews.com/liveblog/fn/prod/images/2026/03/0630a4a80339849543476c9388041597.jpg",
            "publishedAt": "2026-03-12T07:11:32Z",
            "lang": "en",
            "source": {
                "id": "a8408ad388422503ac33101396026891",
                "name": "Fox News",
                "url": "https://www.foxnews.com"
            }
        },
        {
            "id": "13304bc65b31b3f975dc7b01a55dea5e",
            "title": "Cómo la guerra de Trump con Irán podría darle a Putin un premio de lotería",
            "description": "Sería un giro extraordinario si Putin emergiera como el primer ganador de la cada vez más profunda crisis en Medio Oriente porque Trump sacudió los mercados energéticos mundiales al lanzar su propia guerra.",
            "content": "Si el cuarto de siglo de Gobierno expansionista de Vladimir Putin ha enseñado algo a Occidente es que no se debe tomar la palabra del presidente ruso al pie de la letra.\nEso no ha impedido que altos funcionarios estadounidenses se traguen constanteme... [9122 chars]",
            "url": "https://cnnespanol.cnn.com/2026/03/12/mundo/analisis-guerra-trump-iran-putin-premio-loteria-trax",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2266026800-20260312044303171.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-12T06:11:00Z",
            "lang": "es",
            "source": {
                "id": "3c9d862fa32f79b035b88873a5d21ccb",
                "name": "CNN en Español",
                "url": "https://cnnespanol.cnn.com"
            }
        }
    ]
}

Categories