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": 223158,
    "articles": [
        {
            "id": "46c31199967db79217c073afc7e5ed2e",
            "title": "Are we witnessing the death of expertise?",
            "description": "Analyst Tom Nichols says the Trump administration is fundamentally incompetent. And he says there’s been a systematic erosion of expert trust for years — which is dangerous for American democracy.",
            "content": "Analyst Tom Nichols says the Trump administration is fundamentally incompetent. And he says there’s been a systematic erosion of expert trust for years — which is dangerous for American democracy.\nGuests\nTom Nichols, staff writer at The Atlantic. Pro... [40304 chars]",
            "url": "https://www.wbur.org/onpoint/2026/03/23/death-of-expertise-trump-democracy",
            "image": "https://wordpress.wbur.org/wp-content/uploads/2026/03/Trump_26077735255133-1000x667.jpg",
            "publishedAt": "2026-03-24T05:28:11Z",
            "lang": "en",
            "source": {
                "id": "4673638650f9086d927ffc44d4f83682",
                "name": "WBUR",
                "url": "https://www.wbur.org"
            }
        },
        {
            "id": "5521c38998894932f8c2071907b95e54",
            "title": "Iran Update, March 23, 2026",
            "description": "US President Donald Trump extended his deadline for Iran to reach a deal with the United States to March 27.",
            "content": "The Institute for the Study of War (ISW) and The Critical Threats Project (CTP) at the American Enterprise Institute are publishing daily updates to provide analysis on the war with Iran. The updates focus on US and Israeli strikes on Iran and Iran a... [342 chars]",
            "url": "https://understandingwar.org/research/middle-east/iran-update-special-report-march-23-2026/",
            "image": "https://understandingwar.org/wp-content/uploads/2025/10/Website-Featured-Image-1-scaled.webp",
            "publishedAt": "2026-03-24T02:44:58Z",
            "lang": "en",
            "source": {
                "id": "41fdc887bd765811a368dcd8b6dd6835",
                "name": "Institute for the Study of War",
                "url": "https://understandingwar.org"
            }
        },
        {
            "id": "cfddcfbfd1099cb0132fe3bcabda60f5",
            "title": "General McChrystal warns Trump's in over his head",
            "description": "President Donald Trump’s “recent adventurism” in Iran is likely to fail, warned a retired four-star general on Monday — and it is because he does not understand the magnitude of what he has done in Iran.Speaking with David French of The New York Times, retired General Stanley A. McChrystal linked Tr...",
            "content": "President Donald Trump’s “recent adventurism” in Iran is likely to fail, warned a retired four-star general on Monday — and it is because he does not understand the magnitude of what he has done in Iran.\nSpeaking with David French of The New York Tim... [4736 chars]",
            "url": "https://www.alternet.org/trump-in-over-his-head/",
            "image": "https://www.alternet.org/media-library/image.jpg?id=65387960&width=1200&height=600&coordinates=0%2C166%2C0%2C167",
            "publishedAt": "2026-03-24T02:14:00Z",
            "lang": "en",
            "source": {
                "id": "9d34aa1263749cc73cab7e20a5a00d51",
                "name": "alternet.org",
                "url": "https://www.alternet.org"
            }
        }
    ]
}

Categories