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": 196132,
    "articles": [
        {
            "id": "7b9fb733ad2eaba32a78dd70fae0b2cc",
            "title": "Mexico’s president says cancellation of oil shipment to Cuba is ‘sovereign’ decision",
            "description": "Claudia Sheinbaum denied move was response to pressure from the US, after Trump said ‘zero’ oil would go to Cuba",
            "content": "Mexico has cancelled a shipment of oil to Cuba, the country’s president, Claudia Sheinbaum, appeared to confirm on Tuesday, but she insisted the decision was “sovereign” and not a response to pressure from the US.\nFuel shortages are causing increasin... [2195 chars]",
            "url": "https://www.theguardian.com/world/2026/jan/27/mexico-cuba-trump-oil",
            "image": "https://i.guim.co.uk/img/media/d807e6257723a0c88e7af3dc397e4fa81b1b7e47/500_0_5000_4000/master/5000.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=551759e63c8fb3c883a40340e50804e0",
            "publishedAt": "2026-01-27T19:41:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "49a3eca764a5b1cab7dec03a1669076f",
            "title": "Terror infiltration in south Israel was false alarm",
            "description": "The red alert in Paran was the result of Jordanian border police officers chasing criminals into Israeli territory.",
            "content": "The suspected terror infiltration near the Israel-Jordan border has been deemed a false alarm, the IDF said in a Tuesday evening statement.\nThe infiltrators were identified as Jordanian Border Police officers chasing criminals into Israeli territory,... [970 chars]",
            "url": "https://www.jpost.com/israel-news/defense-news/article-884749",
            "image": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/393240",
            "publishedAt": "2026-01-27T19:40:09Z",
            "lang": "en",
            "source": {
                "id": "78834c45a26f98bca295cc641123cf7f",
                "name": "jpost.com",
                "url": "https://www.jpost.com"
            }
        },
        {
            "id": "fd0d7f6749dc24c75ab6dde93a94f32a",
            "title": "El país de América Latina en la mira militar de Estados Unidos tras una filtración iraní",
            "description": "Tras revelaciones sobre la presencia de agentes de Irán en América Latina, Estados Unidos intensifica su vigilancia sobre un país de la región.",
            "content": "Lo que comenzó como un episodio aislado terminó por exponer una combinación delicada de espionaje, influencia regional y tensiones políticas internas, suficiente para despertar el interés del Pentágono y volver a colocar a América Latina en el tabler... [2087 chars]",
            "url": "https://www.diariouno.com.ar/sociedad/el-pais-america-latina-la-mira-militar-estados-unidos-una-filtracion-irani-n1521051",
            "image": "https://media.diariouno.com.ar/p/008e17f8dbf1ba91e4c422bde72997bc/adjuntos/298/imagenes/009/694/0009694194/1200x675/smart/bolivia-3.jpg",
            "publishedAt": "2026-01-27T18:53:00Z",
            "lang": "es",
            "source": {
                "id": "70159afc918b4fd9fd5c85d908e546bb",
                "name": "diariouno.com.ar",
                "url": "https://www.diariouno.com.ar"
            }
        }
    ]
}

Categories