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": 233276,
    "articles": [
        {
            "id": "e3609c4b123fa6dfecd99b8025119325",
            "title": "Japan’s Cherry Blossom Database, 1,200 Years Old, Has a New Keeper",
            "description": "The remarkable catalog of dates is one of the longest-running records of climate change. Its creator died, setting off a search for a successor.",
            "content": "For more than 1,200 years, Japanese noblemen, monks and bureaucrats have carefully recorded one of the most eagerly awaited days of the year — when cherry blossoms bloom in the ancient capital, Kyoto.\nIn recent years, a climate scientist, Yasuyuki Ao... [1242 chars]",
            "url": "https://www.nytimes.com/2026/04/17/climate/japan-cherry-blossom-database-scientist.html",
            "image": "https://static01.nyt.com/images/2026/04/16/multimedia/00CLI-BLOSSOM-CRISIS-03b-twfv/00CLI-BLOSSOM-CRISIS-03b-twfv-facebookJumbo.jpg",
            "publishedAt": "2026-04-18T04:24:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "f8ec7895c11a67998f3296045494a147",
            "title": "Meta y la jurisdicción colombiana: un precedente en construcción",
            "description": "“Meta reconoce la necesidad de mejorar la transparencia, la información disponible y las garantías procedimentales”: Carolina Botero",
            "content": "La Corte Constitucional colombiana publicó esta semana un comunicado de prensa inusual: allí no se refiere a sus decisiones, sino que hace eco del informe de cumplimiento a una tutela que fue presentada contra la empresa estadounidense Meta Inc, prop... [4825 chars]",
            "url": "https://www.elespectador.com/opinion/columnistas/carolina-botero-cabrera/meta-y-la-jurisdiccion-colombiana-un-precedente-en-construccion/",
            "image": "https://www.elespectador.com/resizer/v2/EXHPBC36UVDQHLMKCW44HOLQ2M.jpg?auth=3f606c1be13781dc09d1ac847dbc1bb68c99e7732d4bba6e8e8d3792222e2258&width=657&smart=true&quality=60",
            "publishedAt": "2026-04-18T03:04:00Z",
            "lang": "es",
            "source": {
                "id": "0ba6ff8ab280a825f29c9dcca5072c2c",
                "name": "El Espectador",
                "url": "https://www.elespectador.com"
            }
        },
        {
            "id": "0f5338abceb344bdf93969f628d5e30b",
            "title": "Russian Offensive Campaign Assessment, April 17, 2026",
            "description": "Russian state polls are acknowledging the growing societal discontent with Russian President Vladimir Putin.",
            "content": "Toplines\nOfficials in Russian regions that the Kremlin has historically sought to shield from the effects of the war in Ukraine are beginning to acknowledge the impacts of Ukrainian long-range drone strikes in the Russian rear. Leningrad Oblast Gover... [15945 chars]",
            "url": "https://understandingwar.org/research/russia-ukraine/russian-offensive-campaign-assessment-april-17-2026/",
            "image": "https://understandingwar.org/wp-content/uploads/2025/08/Website-Featured-Image-2-scaled.webp",
            "publishedAt": "2026-04-18T01:48:18Z",
            "lang": "en",
            "source": {
                "id": "41fdc887bd765811a368dcd8b6dd6835",
                "name": "Institute for the Study of War",
                "url": "https://understandingwar.org"
            }
        }
    ]
}

Categories