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": 201098,
    "articles": [
        {
            "id": "5dca35027e30578e9e44ec99de1a9198",
            "title": "Javier Milei impulsa un bloque regional contra el “cáncer del socialismo”",
            "description": "El presidente argentino anticipa que el grupo estará integrado por diez países latinoamericanos",
            "content": "El presidente argentino, Javier Milei, anunció en una entrevista en la noche del jueves que trabaja en la creación de un bloque regional con otros países gobernados por la derecha. El objetivo de la alianza es, según Milei, plantarse “frente al cánce... [3064 chars]",
            "url": "https://elpais.com/argentina/2026-01-02/javier-milei-impulsa-un-bloque-regional-contra-el-cancer-del-socialismo.html",
            "image": "https://imagenes.elpais.com/resizer/v2/TDJ3GNYYHNDLXHMW6YGZ3HYRHA.jpg?auth=3363913dca7394444eb3d1050ce15b5a6bdf49469ffa96a2b577ce2552b02519&width=1200",
            "publishedAt": "2026-01-02T17:15:32Z",
            "lang": "es",
            "source": {
                "id": "eb1bfc7349a10fd1bd06d9ecfaa8b438",
                "name": "EL PAÍS",
                "url": "https://elpais.com"
            }
        },
        {
            "id": "9b54cc6d7c9bdb9d6119f46d03fb2a8c",
            "title": "Elon Musk’s Grok AI generates images of ‘minors in minimal clothing’",
            "description": "xAI says it is working to improve systems after lapses in safeguards led to wave of sexualized images this week",
            "content": "Elon Musk’s chatbot Grok posted on Friday that lapses in safeguards had led it to generate “images depicting minors in minimal clothing” on social media platform X. The chatbot, a product of Musk’s company xAI, has been generating a wave of sexualize... [1902 chars]",
            "url": "https://www.theguardian.com/technology/2026/jan/02/elon-musk-grok-ai-children-photos",
            "image": "https://i.guim.co.uk/img/media/cd6bab13050c473700728d0f80d36ae2782427bc/243_0_2425_1940/master/2425.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=959cfac56de8168ee44e6a01e4998e69",
            "publishedAt": "2026-01-02T16:30:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "eb3712f2f05ad211517c0ced9aef0d70",
            "title": "‘Flashover fire,’ explained: How the Swiss ski resort blaze quickly developed",
            "description": "Swiss authorities have said that a deadly fire at a ski resort bar in Crans-Montana, Switzerland, rapidly developed into a “flashover” – a dangerous phenomenon in which everything in a room ignites almost simultaneously.",
            "content": "Swiss authorities have said that a deadly fire at a ski resort bar in Crans-Montana, Switzerland, rapidly developed into a “flashover” – a dangerous phenomenon in which everything in a room ignites almost simultaneously.\nThe blaze quickly grew into a... [2572 chars]",
            "url": "https://www.cnn.com/2026/01/02/europe/flashover-fire-switzerland-ski-resort-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2253767899.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-02T16:27:51Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories