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": 233110,
    "articles": [
        {
            "id": "7d88ed06b35830dadfe455aedfd49c38",
            "title": "Cinco soluciones para aliviar la crisis de vivienda",
            "description": "Establecer límites para que las residencias heredadas estén vacías y reducir o diferir el pago de arbitrios de construcción figuran entre las alternativas que proveen expertos",
            "content": "En Puerto Rico, pasan los años sin que se concreten soluciones para aliviar la crisis de vivienda que experimenta la clase trabajadora, particularmente el segmento joven, a pesar de que múltiples estudios advierten que la falta de techo seguro limita... [538 chars]",
            "url": "https://www.elnuevodia.com/negocios/bienes-raices/notas/cinco-soluciones-para-aliviar-la-crisis-de-vivienda/",
            "image": "https://www.elnuevodia.com/resizer/v2/AYQ7T7DE3BDQVPBVOME2KUETTA.jpg?auth=58257b543764e86d0376400adfc48563874220432838fd807cc21d760b533b38&quality=75&width=1200&height=717&focal=771%2C421",
            "publishedAt": "2026-05-17T19:20:45Z",
            "lang": "es",
            "source": {
                "id": "dcbaf0be33203c3a7f047c2a890430ab",
                "name": "Noticias de Puerto Rico hoy",
                "url": "https://www.elnuevodia.com"
            }
        },
        {
            "id": "08aba7d0a4871929b59b0ac0db318999",
            "title": "Wave of Ukrainian Strikes Kills at Least 4, Russia Says",
            "description": "More than 550 drones were intercepted or shot down in more than a dozen regions, including Moscow, in one of largest attacks of the war.",
            "content": "At least four people were killed by Ukrainian drone strikes across Russia, including in Moscow, on Sunday in the biggest attack by Ukraine this year and one of its largest of the war, according to the local authorities and Tass, the Russian state-own... [1845 chars]",
            "url": "https://www.nytimes.com/2026/05/17/world/europe/russia-ukraine-strikes-moscow.html",
            "image": "https://static01.nyt.com/images/2026/05/17/multimedia/17int-russia-ukraine-cjkf/17int-russia-ukraine-cjkf-facebookJumbo.jpg",
            "publishedAt": "2026-05-17T19:17:17Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "6d79ac4260c4252ac559ca8bca8a951e",
            "title": "Insiste Morena que fueron 20 mil a la marcha",
            "description": "Recolectarán firmas contra Maru en todo el país",
            "content": "Chihuahua.- La dirigencia nacional de Morena que dirige Ariadna Montiel, a través de un comunicado de prensa, anunció que luego de la marcha de Chihuahua recorrerá el país para recolectar firmas en contra de la Gobernadora de Chihuahua, María Eugenia... [1025 chars]",
            "url": "https://diario.mx/estado/2026/may/17/insiste-morena-que-fueron-20-mil-a-la-marcha-1118478.html",
            "image": "https://diario.mx/core/dmx/assets/images/2026/05/17/middle-morena-1wzEr56Rf.jpg",
            "publishedAt": "2026-05-17T16:35:00Z",
            "lang": "es",
            "source": {
                "id": "3152ec51cfb5ab390dc4739249a809cd",
                "name": "diario.mx",
                "url": "https://diario.mx"
            }
        }
    ]
}

Categories