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": 224812,
    "articles": [
        {
            "id": "de72b277dc9338c727ce850f105c4326",
            "title": "Alcalde de Villalba será trasladado al Centro Médico de Río Piedras tras enfrentar complicaciones de salud",
            "description": "Enfrenta “un cuadro de salud delicado”, se informó.",
            "content": "El alcalde novoprogresista de Villalba, Danny “Dan” Santiago Núñez, será trasladado este sábado al Centro Médico de Río Piedras a recibir tratamiento especializado.\nEl ejecutivo municipal enfrentó ayer, viernes, complicaciones de salud que llevaron a... [2133 chars]",
            "url": "https://www.primerahora.com/noticias/gobierno-politica/notas/alcalde-de-villalba-sera-trasladado-al-centro-medico-de-rio-piedras-tras-enfrentar-complicaciones-de-salud/",
            "image": "https://www.primerahora.com/resizer/v2/BKMQGWRQ3NFRZMCQ2HN4Q6QDME.jpg?auth=37dbef5645740a88d84db497ea3bf0dae4c5c3268f5f70012b4ab9919b4bc585&quality=75&width=1200&height=717&focal=579%2C512",
            "publishedAt": "2026-03-28T18:49:45Z",
            "lang": "es",
            "source": {
                "id": "0ff9d9aa3439f245d940177440bfe1dd",
                "name": "Primera Hora",
                "url": "https://www.primerahora.com"
            }
        },
        {
            "id": "908ec5f192d39d5f4d542790909e5fb4",
            "title": "Pope Leo XIV uses visit to Monaco to urge it to use its wealth for good",
            "description": "Pope Leo XIV has urged the people of Monaco to use their Catholic faith and wealth for good. In his homily at the end of a one-day visit, Leo urged them to reject the “idolatry of power and money” that is fueling wars around the world.",
            "content": "MONACO (AP) — Pope Leo XIV urged residents of the principality of Monaco on Saturday to use their wealth and influence for good and reject the “idolatry of power and money” that is fueling wars around the world.\nLeo made a one-day trip to the glitzy ... [4666 chars]",
            "url": "https://apnews.com/article/pope-leo-xiv-monaco-visit-prince-albert-a1127845562357d13d5b6994444db256",
            "image": "https://dims.apnews.com/dims4/default/982adcb/2147483647/strip/true/crop/2496x1663+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fe9%2Fb5%2F9202efd71fe223935c689e94e086%2Feb82a7eeeb2a4cbc9bdd6df0d405e4bf",
            "publishedAt": "2026-03-28T17:16:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "889e734f8049098952ea03061a6caed8",
            "title": "U.S. troops injured in Saudi base as the war reaches one month : NPR",
            "description": "An Iranian strike on an air base in Saudi Arabia wounded at least 15 U.S. service members. Israel also said it intercepted a missile launched from Iran-backed Houthi rebels in Yemen.",
            "content": "At least 15 U.S. service members were wounded Friday in an Iranian strike on a Saudi air base that hosts American troops, according to the Associated Press, including at least five in serious condition. The missile and drone strikes targeted Saudi Ar... [7788 chars]",
            "url": "https://www.npr.org/2026/03/28/nx-s1-5764720/iran-war-one-month",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/1024x576+0+54/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2Fa6%2F97%2F3e48821a4bf1bac0c380189f2b63%2Fgettyimages-2268068294.jpg",
            "publishedAt": "2026-03-28T17:05:00Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories