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": 197368,
    "articles": [
        {
            "id": "6163982f4be796c4392a4debd025278f",
            "title": "Prime Minister will fight any attempt to replace him, friends say",
            "description": "Allies of the prime minister are worried his job might be under immediate threat.",
            "content": "Allies of the prime minister are making it clear he would fight any challenge to his leadership from Labour MPs.\nThere are fears from those loyal to Sir Keir Starmer that his job might be under immediate threat, perhaps as soon as shortly after the B... [5018 chars]",
            "url": "https://www.bbc.com/news/articles/c5y0z2q2g2ro",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/700a/live/4a055f00-bf45-11f0-8456-eff94716b162.jpg",
            "publishedAt": "2025-11-11T20:56:58Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "e67ae13be0a746852e60b9e5c5471f47",
            "title": "Ficha clave del 'Tren de Aragua', al que daban por muerto en registros de Venezuela, se escondía en hotel de Cartagena",
            "description": "El señalado capo se movía por Medellín, Caracas y Bogotá con cédula colombiana. Es señalado de coordinar envíos de cocaína hacia Estados Unidos.",
            "content": "Un Grupo de Operaciones Especiales de la Policía llegó el pasado 7 de noviembre a un hotel ubicado en el barrio El Bosque, a tres cuadras de las playas de Cartagena, para hacer efectiva la captura de uno de los huéspedes que completaba una semana en ... [3923 chars]",
            "url": "https://www.eltiempo.com/unidad-investigativa/ficha-clave-del-tren-de-aragua-al-que-daban-por-muerto-en-registros-de-venezuela-se-escondia-en-hotel-de-cartagena-3507929",
            "image": "https://imagenes2.eltiempo.com/files/og_thumbnail/files/fp/uploads/2025/11/11/691370e5b297d.r_d.70-286-0.png",
            "publishedAt": "2025-11-11T19:01:41Z",
            "lang": "es",
            "source": {
                "id": "58dd8560c9b69789426e2f65cf9472fd",
                "name": "ELTIEMPO.COM",
                "url": "https://www.eltiempo.com"
            }
        },
        {
            "id": "4789361358b15a1f83bf300f0c1e23e3",
            "title": "Turkey Seeks Jail Sentence of Over 2,000 Years for Istanbul Mayor Ekrem Imamoglu",
            "description": "Prosecutors accused Ekrem Imamoglu, the mayor of Istanbul, of leading a criminal organization. The opposition called the case politically motivated.",
            "content": "A Turkish prosecutor accused the jailed mayor of Istanbul of running a criminal organization and called for him to be sentenced to more than 2,000 years in prison, according to an indictment presented in court on Tuesday.\nThe indictment accused the m... [3388 chars]",
            "url": "https://www.nytimes.com/2025/11/11/world/middleeast/istanbul-mayor-jail-sentence-turkey.html",
            "image": "https://static01.nyt.com/images/2025/11/11/multimedia/11INT-turkey-opposition-lctf/11INT-turkey-opposition-lctf-facebookJumbo.jpg",
            "publishedAt": "2025-11-11T18:20:38Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories