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": 200868,
    "articles": [
        {
            "id": "a0f194f00fa2717b5ab2471c748d6215",
            "title": "Iran arrests protest leaders as crackdown intensifies amid threat of US intervention",
            "description": "Washington and Tehran step up war of words over Donald Trump’s threat to intervene in response to unrest",
            "content": "Iranian authorities have arrested key members of the protest movement that has rocked the country over the last two weeks, the national police chief has said, as Washington and Tehran threaten each other over the prospect of US intervention in the Is... [5937 chars]",
            "url": "https://www.theguardian.com/world/2026/jan/11/iran-arrests-protest-leaders-as-crackdown-intensifies-amid-threat-of-us-intervention",
            "image": "https://i.guim.co.uk/img/media/69ecda6d7df41558a71d877fe0ea974fce5209c7/500_0_5000_4000/master/5000.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=6e8f68e6c9e84e6af4b8357c2edef8a8",
            "publishedAt": "2026-01-11T14:21:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "f2609017d5edf12bb96b2f9f92e0fe3b",
            "title": "Planearon 30 agresión a policías estatales",
            "description": "Indica línea de investigación que el plan incluye a ‘El Nomo’, medio hermano del fundador de La Empresa, René Gerardo G. S., alias ‘El 300’",
            "content": "Ciudad Juárez.- La Secretaría de Seguridad Pública Estatal (SSPE) indicó haber identificado a una red de alrededor de 30 personas como probables implicadas en el ataque armado del jueves, que dejó un elemento de esa corporación asesinado y a otros do... [5687 chars]",
            "url": "https://diario.mx/juarez/2026/jan/11/planearon-30-agresion-a-policias-estatales-1101181.html",
            "image": "https://diario.mx/core/dmx/assets/images/2026/01/11/middle-10-Gj0iDndb7.jpg",
            "publishedAt": "2026-01-11T14:00:00Z",
            "lang": "es",
            "source": {
                "id": "3152ec51cfb5ab390dc4739249a809cd",
                "name": "diario.mx",
                "url": "https://diario.mx"
            }
        },
        {
            "id": "c3cb434a9517da5531f272544491700a",
            "title": "Amanece Ciudad Juárez con sensación térmica de -7 °C",
            "description": "Se esperan 13 °C como temperatura máxima en el día",
            "content": "Ciudad Juárez.- La jornada de este domingo estará marcada por un ambiente gélido desde las primeras horas, con temperaturas que intensifican la sensación de frío en la frontera, de acuerdo con información de The Weather Channel. Aunque el cielo se ma... [1020 chars]",
            "url": "https://diario.mx/juarez/2026/jan/11/amanece-ciudad-juarez-con-sensacion-termica-de-7-c-1101180.html",
            "image": "https://diario.mx/core/dmx/assets/images/2026/01/11/middle-20220207091627184-0-1895257-x2lakhvxh-SDKFcFUQR.jpg",
            "publishedAt": "2026-01-11T12:35:00Z",
            "lang": "es",
            "source": {
                "id": "3152ec51cfb5ab390dc4739249a809cd",
                "name": "diario.mx",
                "url": "https://diario.mx"
            }
        }
    ]
}

Categories