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": 222338,
    "articles": [
        {
            "id": "19ac164986b8f566e91be785c58dc036",
            "title": "Israel passes law to give death penalty to Palestinians convicted of lethal attacks",
            "description": "Knesset approves measure that has been criticised by European nations and rights groups",
            "content": "Israel’s parliament has passed a law imposing the death penalty on Palestinians convicted of fatal attacks, a measure sharply criticised as discriminatory by European nations and rights groups.\nThe legislation makes the death penalty the default puni... [4246 chars]",
            "url": "https://www.theguardian.com/world/2026/mar/30/israel-passes-law-death-penalty-palestinian-convicted-terrorists",
            "image": "https://i.guim.co.uk/img/media/042ed794017eccc21db3dbf9953e36d98430ca54/414_0_2068_1655/master/2068.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=f54acfe86a719b1e3c21a9411a17c283",
            "publishedAt": "2026-03-30T18:38:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "991bbca35bd1735fc7b885686851badf",
            "title": "Spain closes its airspace to US planes involved in the Iran war",
            "description": "Spain has closed its airspace to U.S. planes involved in the Iran war, after earlier saying the U.S. couldn't use jointly operated military bases there for operations related to the conflict.",
            "content": "MADRID (AP) — Spain said Monday it has closed its airspace to U.S. planes involved in the Iran war, another step by Europe’s loudest critic of U.S. and Israeli military actions in the monthlong conflict.\nThe country earlier said the U.S. couldn’t use... [2353 chars]",
            "url": "https://apnews.com/article/trump-spain-united-states-iran-war-05e23ef4e0bda9cb226a16b10cd9437c",
            "image": "https://dims.apnews.com/dims4/default/83c21af/2147483647/strip/true/crop/5673x3780+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F21%2Fda%2F71015cc5697390aeeac1c0e2c326%2F2c5795094cac4d0d9845ec3d5fddb504",
            "publishedAt": "2026-03-30T18:36:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "f5e0f2f937ad564bbb39e1a53d67a8f8",
            "title": "Capturan a sospechoso de robo registrado en parqueadero de vía a la costa",
            "description": "Las cámaras de Segura EP realizaron el seguimiento del vehículo involucrado.",
            "content": "La Policía Nacional capturó a Danny César B. N., de 44 años, por el robo registrado en el parqueadero de un centro comercial de la vía a la costa, en el norte de Guayaquil.\nEl hecho quedó grabado en cámaras de seguridad del sector y se volvió viral e... [597 chars]",
            "url": "https://www.eluniverso.com/noticias/seguridad/capturan-a-sospechoso-de-robo-registrado-en-parqueadero-de-via-a-la-costa-nota/",
            "image": "https://www.eluniverso.com/resizer/v2/GN6Y5HQLEBHD7FQAFICNZACU3M.jpeg?auth=eaae4f552b0f03d51a6149a8ac0ad3aecf52f8ed417c9d51178324ac13b2fd6d&width=566&height=670&quality=75&smart=true",
            "publishedAt": "2026-03-30T17:48:45Z",
            "lang": "es",
            "source": {
                "id": "fbe62a94a891b65106bff187fef25f02",
                "name": "El Universo",
                "url": "https://www.eluniverso.com"
            }
        }
    ]
}

Categories