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": 205842,
    "articles": [
        {
            "id": "61ac6ae35c3adb3b18034ed2b565f451",
            "title": "Activists say they verified over 5,000 killed in Iran protests; Trump: 'Armada' headed to region",
            "description": "US-based Human Rights Activists' News Agency warns many more feared dead, as internet blackout crosses 2-week mark",
            "content": "The death toll from Iran’s bloody crackdown on nationwide protests reached at least 5,002 people killed Friday, activists said, warning many more still were feared dead as the most comprehensive internet blackout in the country crossed the two-week m... [3862 chars]",
            "url": "https://www.timesofisrael.com/activists-raise-iran-protest-crackdown-death-toll-to-over-5000-trump-armada-headed-to-region/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/01/2026-01-11T174532Z_41089504_RC2ZYIAIE7HS_RTRMADP_3_IRAN-ECONOMY-PROTEST-BODIES-UGC-1-e1769178580934.jpg",
            "publishedAt": "2026-01-23T14:40:32Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "timesofisrael.com",
                "url": "https://www.timesofisrael.com"
            }
        },
        {
            "id": "849593e7a5c1f2511b910d9aef955a1b",
            "title": "Contingente de Fuerza de Supresión de Bandas para Haití llegará a ese país en el mes de abril",
            "description": "En una nota de prensa se indicó que para el mes de octubre se proyecta el despliegue integral de la Fuerza.",
            "content": "El designado representante especial de la Fuerza de Supresión de Bandas para Haití (GSF, siglas en inglés), Jack Christofides, informó que los primeros contingentes de ese órgano llegarán en el mes de abril al vecino país.\nEn una nota de prensa se in... [1685 chars]",
            "url": "https://listindiario.com/la-republica/20260123/contingente-fuerza-supresion-bandas-haiti-llegara-ese-pais-mes-abril_891071.html",
            "image": "https://listindiario.com/files/main_image/uploads/2025/06/08/6846084bef58e.jpeg",
            "publishedAt": "2026-01-23T14:28:59Z",
            "lang": "es",
            "source": {
                "id": "7074f1cc47668a543e8a020af3653d47",
                "name": "Listín Diario",
                "url": "https://listindiario.com"
            }
        },
        {
            "id": "741f66b9dc5063b25a6e174fc5c2013b",
            "title": "Venezuela anunció dos nuevos cambios en el mando militar",
            "description": "Se trata de los comandantes de las Zonas de Defensa Integral en los estados Trujillo y Nueva Esparta",
            "content": "El Gobierno de Venezuela dispuso dos cambios en la conducción de la Fuerza Armada Nacional Bolivariana (FANB), al renovar los comandantes de las Zonas de Defensa Integral (Zodi) en los estados Trujillo y Nueva Esparta. Así lo informó el comandante es... [1370 chars]",
            "url": "https://www.infobae.com/venezuela/2026/01/23/venezuela-anuncio-dos-nuevos-cambios-en-el-mando-militar/",
            "image": "https://www.infobae.com/resizer/v2/EDFCP6VPQFFX7GJKBZGOTMTLDM.png?auth=4db0d1a941dd1bed0c9913b18b0395d6f3123a8ef99e80e734a3061efa7cdfb0&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-01-23T13:34:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

United States World News API

API Demonstration

Categories