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": 243494,
    "articles": [
        {
            "id": "f7dc943f2cb3e3af2fcbd0a534b19c12",
            "title": "Iranians Take to Streets to Celebrate Khamenei’s Death",
            "description": "Some Iranians said on social media that they were privately mourning the supreme leader. But displays of exuberance broke out in cities across the country.",
            "content": "Large crowds of Iranians poured into the streets of Tehran and other cities across Iran overnight, celebrating the news that Iran’s supreme leader, Ayatollah Ali Khamenei, had been killed during a day of coordinated U.S. and Israeli attacks.\nThe ayat... [1753 chars]",
            "url": "https://www.nytimes.com/2026/02/28/world/middleeast/iran-khameni-celebrations.html",
            "image": "https://static01.nyt.com/images/2026/02/28/arts/Iran_esfaham_2/Iran_esfaham_2-facebookJumbo.jpg",
            "publishedAt": "2026-03-01T07:48:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "48215f2d1b210c2191dda872f83e7699",
            "title": "RD expresa preocupación por la situación Oriente Medio",
            "description": "El Mirex exhortó a los actores regionales e internacionales con capacidad de influencia a perseverar en los esfuerzos de mediación",
            "content": "El Gobierno de la República Dominicana expresó la noche del sábado su profunda preocupación por la situación de Oriente Medio y comunicó que espera el retorno de la paz y la estabilidad a la región, tras la muerte del líder iraní Alí Jamenei.\n\"Fiel a... [1617 chars]",
            "url": "https://www.diariolibre.com/actualidad/nacional/2026/02/28/rd-expresa-preocupacion-por-la-situacion-oriente-medio/3453008",
            "image": "https://resources.diariolibre.com/images/2025/03/07/imagen-mirex-d8237a68-538537a5-focus-0-0-895-573-60f1d17c-focus-0-0-1200-675_wam.jpg",
            "publishedAt": "2026-03-01T03:20:00Z",
            "lang": "es",
            "source": {
                "id": "2f5cf3a171d0a1f51784dd36ae84d622",
                "name": "Diario Libre",
                "url": "https://www.diariolibre.com"
            }
        },
        {
            "id": "74caf91574377f70e52f0bc978e3c539",
            "title": "Sismo se sintió en Quito la noche del sábado 28 de febrero",
            "description": "De acuerdo al reporte del Instituto Geofísico, el sismo fue de 3.5 de magnitud.",
            "content": "Un sismo de 3.5 de magnitud se registró a las 20:57 a 26.86 kilómetros de Quito, en la provincia de Pichincha.\nEl movimiento telúrico tuvo una profundidad de once kilómetros, según el reporte del Instituto Geofísico.\n‘Estábamos aquí rezando y empezar... [403 chars]",
            "url": "https://www.eluniverso.com/noticias/ecuador/sismo-se-sintio-en-quito-la-noche-del-sabado-28-de-febrero-nota/",
            "image": "https://www.eluniverso.com/resizer/v2/PWJVQA5VTNF2DNAWB45PYTPVHQ.jpg?auth=aabd601a8292385a1cfabaab9f9532280e64d5246f5358de490d4fc1f14f3be5&width=668&height=670&quality=75&smart=true",
            "publishedAt": "2026-03-01T01:57:10Z",
            "lang": "es",
            "source": {
                "id": "fbe62a94a891b65106bff187fef25f02",
                "name": "El Universo",
                "url": "https://www.eluniverso.com"
            }
        }
    ]
}

Categories