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": 237700,
    "articles": [
        {
            "id": "a8d50c912760eeedcebc283c80449470",
            "title": "Pakistan’s defense minister says that there is an 'open war' with Afghanistan",
            "description": "Pakistan and Afghanistan have traded attacks in a dramatic escalation of tensions between the countries.",
            "content": "ISLAMABAD (AP) — Pakistan and Afghanistan exchanged cross-border attacks overnight in a dramatic escalation of tensions that led to Pakistan’s defense minister to say on Friday that the two countries are in a state of “open war.”\nAfghanistan launched... [6700 chars]",
            "url": "https://apnews.com/article/afghanistan-pakistan-airstrikes-open-war-98927b79ee9ef5741bf0804956d3c2e6",
            "image": "https://dims.apnews.com/dims4/default/68f2bc8/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ff6%2F2a%2Fd4d9777aebb540e8e13e03c28491%2Fdb9aa862388248c3ade2de0ccb98bff1",
            "publishedAt": "2026-02-27T14:14:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "d3c159a4b9f5c6396f8e63119efdfc78",
            "title": "USS Ford Arrives in Israel Amid Iran Tensions as IDF Says No Change in Guidelines",
            "description": "USS Ford Arrives in Israel. U.K. Withdraws Staff From Iran Temporarily. Iran Stored Highly Enriched Uranium at Underground Site, IAEA Report Says",
            "content": "Some ‌of Iran's most ‌highly enriched uranium, close to weapons ⁠grade, was stored ⁠in an underground area of its nuclear site in Isfahan, the UN nuclear watchdog said ‌in a confidential report ‌sent to member states on Friday and seen by Reuters.\nIt... [5865 chars]",
            "url": "https://www.haaretz.com/israel-news/israel-security/2026-02-27/ty-article-live/report-u-s-central-command-commander-briefs-trump-on-possible-attacks-on-iran/0000019c-9d63-d981-a1be-9ffb0e270000",
            "image": "https://img.haarets.co.il/bs/0000019c-9d63-d981-a1be-9ffb0e270000/0f/7c/b3bfb30a49709a273423c8c218b1/913364.jpg?precrop=2400,1395,x0,y0&width=1200&height=630&cmsprod",
            "publishedAt": "2026-02-27T13:42:00Z",
            "lang": "en",
            "source": {
                "id": "bdf99ac789962533519a03e81267024f",
                "name": "Haaretz",
                "url": "https://www.haaretz.com"
            }
        },
        {
            "id": "1f674d4c7f6b6e375e6564793eb61880",
            "title": "Green Party Defeats Labour in U.K. Special Election, in Blow to Starmer",
            "description": "The result marks the first time the Greens have won a British parliamentary by-election and signals the frustration of left-leaning voters with Prime Minister Keir Starmer.",
            "content": "The Green Party won a special election on Thursday for a British parliamentary seat in northern England, where left-leaning voters sent Prime Minister Keir Starmer a searing message of dissatisfaction.\nHannah Spencer, 34, a plumber by trade and a mem... [1436 chars]",
            "url": "https://www.nytimes.com/2026/02/26/world/europe/gorton-denton-result-green-party-labour.html",
            "image": "https://static01.nyt.com/images/2026/02/27/multimedia/27int-uk-election-3-wmjf/27int-uk-election-3-wmjf-facebookJumbo-v2.jpg",
            "publishedAt": "2026-02-27T12:32:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories