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": 201298,
    "articles": [
        {
            "id": "b167813ae573fbb4c159c8b88c3ffc80",
            "title": "El Mercosur y la UE firman el acuerdo que crea la zona de libre comercio más grande del mundo: ¿por qué es tan polémico?",
            "description": "El pacto trasatlántico fue rubricado en el mismo recinto donde en 1991 nació el bloque sudamericano.",
            "content": "Autor, Redacción*\nTítulo del autor, BBC News Mundo\n1 hora\nTiempo de lectura: 6 min\nTras casi un cuarto de siglo de negociaciones, el Mercado Común del Sur (Mercosur) y la Unión Europea (UE) firmaron este sábado el acuerdo que crea la zona de libre co... [6035 chars]",
            "url": "https://www.bbc.com/mundo/articles/crkrjrzldzjo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/0a41/live/91b74e00-f3cd-11f0-92c3-936af9d34b29.jpg",
            "publishedAt": "2026-01-17T18:33:45Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "920637bfeb38c2f84346a432e4ccf808",
            "title": "Claves del Acuerdo Mercosur-UE, que promete crear la mayor zona comercial del mundo",
            "description": "La firma del convenio en Asunción es un paso central, pero no definitivo",
            "content": "Tras 26 años de negociaciones, el Acuerdo UE-Mercosur está más cerca de concretarse, con la firma de las partes prevista para este sábado en la ciudad paraguaya de Asunción. Este tratado político y comercial promete la creación de la mayor zona comer... [5572 chars]",
            "url": "https://elpais.com/america/2026-01-17/claves-del-acuerdo-mercosur-ue-que-promete-crear-la-mayor-zona-comercial-del-mundo.html",
            "image": "https://imagenes.elpais.com/resizer/v2/BGVMTYUS3BI5THC5TEYJNGDVU4.jpg?auth=951bcb019c0a021fafa36cf6464ec05483015948046e467484e4f4cc7d690eea&width=1200",
            "publishedAt": "2026-01-17T18:07:32Z",
            "lang": "es",
            "source": {
                "id": "eb1bfc7349a10fd1bd06d9ecfaa8b438",
                "name": "EL PAÍS",
                "url": "https://elpais.com"
            }
        },
        {
            "id": "8708665d4476d5008346852e54f72427",
            "title": "European Union and Mercosur bloc of South American nations sign landmark free trade agreement",
            "description": "The European Union and the Mercosur bloc of South American countries have formally signed a long-sought landmark free trade agreement.",
            "content": "ASUNCIÓN, Paraguay (AP) — The European Union and the Mercosur bloc of South American countries formally signed a long-sought landmark free trade agreement on Saturday, capping more than a quarter-century of torturous negotiations to strengthen commer... [2929 chars]",
            "url": "https://apnews.com/article/mercosur-european-union-trade-agreement-south-america-b779460da4b7ecb6aa15d322976fa70d",
            "image": "https://dims.apnews.com/dims4/default/1f82e45/2147483647/strip/true/crop/5616x3159+0+293/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc6%2Fb1%2Fe4dfc8a6580f87a6da633d1b57d6%2F67a2221c0eaa434aadea0b105ca8825a",
            "publishedAt": "2026-01-17T17:43:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

United States World News API

API Demonstration

Categories