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": 199354,
    "articles": [
        {
            "id": "ddf3b996d2d65e45fe5b6e46c72ad8eb",
            "title": "The Illusion of Isolationism",
            "description": "No one should have expected Trump to retreat.",
            "content": "Citing his contempt for allies and his hostile attitude toward immigration, analysts and commentators often paint U.S. President Donald Trump’s leadership style as a throwback to the isolationist ways of the nineteenth-century United States. This arg... [15070 chars]",
            "url": "https://www.foreignaffairs.com/united-states/illusion-isolationism",
            "image": "https://cdn-live.foreignaffairs.com/sites/default/files/styles/social_share/public/images/2025/12/30/2025-12-20T002620Z_1902582629_RC20KIASMKB3_RTRMADP_3_USA-TRUMP.JPG?itok=olV5B4ZS",
            "publishedAt": "2026-01-05T05:00:00Z",
            "lang": "en",
            "source": {
                "id": "77c0adef2394adebf95bf458030ba8ea",
                "name": "Foreign Affairs",
                "url": "https://www.foreignaffairs.com"
            }
        },
        {
            "id": "431c54d7ab1d0eafb1499bbfce36536b",
            "title": "Switzerland: All victims of bar fire disaster identified",
            "description": "More than half of those who died at a Swiss ski resort celebrating the New Year were under 18 years of age, with two as young as 14. Switzerland will hold a day of mourning on Friday in memory of the victims.",
            "content": "All of the 40 victims who were killed in a bar fire in the Swiss Alps during New Year's celebrations have been identified, police in Switzerland said Sunday.\nTwenty-six of the victims were under the age of 18, while two of those who lost their lives ... [1674 chars]",
            "url": "https://www.dw.com/en/switzerland-bar-fire-all-victims-of-new-years-fire-identified/a-75387162",
            "image": "https://static.dw.com/image/75387275_6.jpg",
            "publishedAt": "2026-01-05T03:46:15Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "7764a5400021656515c997cd96de0629",
            "title": "Chabad House in Kathmandu says it was evicted due to 'clear antisemitism'",
            "description": "Hosts say Nepali landlord told them explicitly to leave after months of demands, including to remove Hebrew signs and rent increases that were 'impossible to meet'",
            "content": "The Chabad House in Kathmandu, Nepal, which hosts thousands of Israeli backpackers every year, said on Sunday it was being forced to abruptly relocate amid growing pressure from its landlord.\nIn a Facebook post, Chani Lifshitz said that she and her h... [1778 chars]",
            "url": "https://www.timesofisrael.com/chabad-house-in-kathmandu-says-it-was-evicted-due-to-clear-antisemitism/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/01/F161226NS168.jpg",
            "publishedAt": "2026-01-05T01:41:15Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories