Flag of the 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": 3182656,
    "articles": [
        {
            "title": "Portugal’s Center Right Wins Election but Falls Short of Majority",
            "description": "The hard-right Chega party surged in the snap election, securing its status as a powerful political contender.",
            "content": "Portugal’s governing center-right coalition won a snap election on Sunday but failed to secure a majority amid a surge in votes for the hard-right Chega party.\nWhile the results are likely to produce little change in Portugal’s leadership, they cemen... [620 chars]",
            "url": "https://www.nytimes.com/2025/05/19/world/europe/portugal-election-montenegro-chega.html",
            "image": "https://static01.nyt.com/images/2025/05/19/multimedia/19portugal-election-01-lwmz/19portugal-election-01-lwmz-facebookJumbo.jpg",
            "publishedAt": "2025-05-19T11:38:16Z",
            "source": {
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "title": "Trump to ask Putin to stop 'bloodbath' in Ukraine peace call",
            "description": "President Donald Trump is expected to speak with Russian President Vladimir Putin at around 10 a.m. ET on Monday.",
            "content": "A Ukrainian soldier carries a mortar shell at a front-line position in the Donetsk region of Ukraine on May 16, 2025.\nA Ukrainian soldier carries a mortar shell at a front-line position in the Donetsk region of Ukraine on May 16, 2025.\nA Ukrainian so... [5358 chars]",
            "url": "https://abcnews.go.com/International/trump-putin-stop-bloodbath-ukraine-peace-call/story?id=121939395",
            "image": "https://i.abcnewsfe.com/a/8f94ba63-1af1-4fda-8835-8b37d1800da5/Ukraine-soldier-DB-250519_1747640164060_hpMain_16x9.jpg?w=1600",
            "publishedAt": "2025-05-19T11:34:52Z",
            "source": {
                "name": "ABC News",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "title": "Donald Trump Forwards Shocker Of A Plea For Barack Obama",
            "description": "The president amplified an extreme message about one of his predecessors.",
            "content": "For two decades, HuffPost has been fearless, unflinching, and relentless in pursuit of the truth. Support our mission to keep us around for the next 20 — we can't do this without you.\nWe remain committed to providing you with the unflinching, fact-ba... [328 chars]",
            "url": "https://www.huffpost.com/entry/donald-trump-barack-obama-military-tribunal_n_682af5f3e4b02ef0f55d4487",
            "image": "https://img.huffingtonpost.com/asset/682af8d31600004a00a09e7e.jpeg?cache=RDiWJwSelH&ops=1200_630",
            "publishedAt": "2025-05-19T10:58:50Z",
            "source": {
                "name": "HuffPost",
                "url": "https://www.huffpost.com"
            }
        }
    ]
}

Categories