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": 224180,
    "articles": [
        {
            "id": "84250663bf1d6dd18ec1d1ef102716f5",
            "title": "At least 30 killed in crush at historic fortress in Haiti",
            "description": "Officials said many killed at popular tourist site were young, with more people reported injured or missing",
            "content": "At least 30 people, many of them young, have died and dozens more are reported to have been injured after a crush at a mountaintop fortress in northern Haiti that is a popular tourist spot.\nJean Henri Petit, the head of civil protection for the count... [2543 chars]",
            "url": "https://www.theguardian.com/world/2026/apr/12/at-least-30-killed-in-crush-at-historic-fortress-in-haiti",
            "image": "https://i.guim.co.uk/img/media/ed8915a922e995c16058e5be2bce5efc7e5b7bf6/459_0_4537_3630/master/4537.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=5569db930632031073152aab20365dc2",
            "publishedAt": "2026-04-12T11:55:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "2e9943efaef28e69b8fb705665036d75",
            "title": "Más de 27 millones de peruanos convocados a las urnas en la elección más compleja de su historia: así se desarrolla la jornada",
            "description": "Más de 27 millones de peruanos votan hoy en las elecciones generales 2026, la jornada más compleja del país. Revisa qué se elige (presidente, vicepresidentes, senadores, diputados y Parlamento Andino), quiénes son los candidatos, cómo votar paso a paso, horario de votación, reglas del proceso, cómo funciona el Congreso bicameral, cuántos electores hay en Perú y el extranjero, si habrá segunda vuelta, multas por no votar y todas las cifras clave de la ONPE.",
            "content": "Más de 27 millones de peruanos están llamados este domingo 12 a las urnas para enfrentarse a las elecciones más difíciles de la historia. Una jornada de votación sin precedentes por múltiples razones. Nunca antes se había tenido 37 organizaciones pol... [6802 chars]",
            "url": "https://elcomercio.pe/politica/elecciones-generales-peru-2026-hoy-12-de-abril-mas-de-27-millones-de-peruanos-convocados-a-las-urnas-en-la-eleccion-mas-compleja-de-su-historia-asi-se-desarrolla-la-jornada-elecciones-en-peru-como-votan-los-peruanos-que-se-elige-presidente-vicepresidentes-60-senadores-130-diputados-y-parlamento-andino-quienes-son-los-candidatos-y-partidos-en-carrera-como-votar-paso-a-paso-cual-es-el-horario-de-votacion-cuales-son-las-reglas-de-la-jornada-electoral-como-funciona-el-congreso-bicameral-cuantos-votantes-hay-en-peru-y-el-extranjero-segunda-vuelta-del-7-de-junio-cuales-son-las-multas-por-no-votar-y-cifras-oficiales-de-la-onpe-tlcnota-noticia/",
            "image": "https://elcomercio.pe/resizer/v2/UDU6TWX67VDTFB35UULHF6MJBA.jpg?auth=6019154015546d7d2632f6ca0dd0a1a62ff9ec1db94164d31c660b2a2e84c623&width=980&height=528&quality=75&smart=true",
            "publishedAt": "2026-04-12T11:49:53Z",
            "lang": "es",
            "source": {
                "id": "108bcc2f42ee620efad6c803b79b7f95",
                "name": "El Comercio Perú",
                "url": "https://elcomercio.pe"
            }
        },
        {
            "id": "58cd4d661082f7cb05453e71636578e6",
            "title": "Elecciones en Perú en vivo: Horarios y cómo votar",
            "description": "Los peruanos concurren a las urnas en unas elecciones generales en las que se postulan 35 candidatos presidenciales. Sigue la cobertura en vivo en vivo de AP en español.",
            "content": "Sandy Muñoz, vendedora de comida en las calles, cree que el próximo presidente de Perú tiene que resolver varios problemas, entre ellos la inseguridad ciudadana y los altos precios de los alimentos.\n“El coste de la vida ha subido demasiado; hoy en dí... [3105 chars]",
            "url": "https://apnews.com/live/peru-en-vivo-elecciones-generales-2026",
            "image": "https://dims.apnews.com/dims4/default/77bf2c4/2147483647/strip/true/crop/6155x4101+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fcc%2F2e%2F8c791ca44b5e993fc1b0a3c4ed9a%2Fap26102481004814.jpg",
            "publishedAt": "2026-04-12T11:23:01Z",
            "lang": "es",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories