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": 203288,
    "articles": [
        {
            "id": "09997ce42320adfaaf84216fa9361129",
            "title": "S Korea's ex-president Yoon to be jailed for five years over martial law bid",
            "description": "This is the first of the verdicts in the four trials linked to Yoon's shock decree in 2024.",
            "content": "8 minutes ago\nJake Kwon ,Seoul correspondentand\nLeehyun Choi ,Seoul\nSouth Korea's impeached president Yoon Suk Yeol will be jailed for five years over abuse of power, obstructing justice and falsifying documents in relation to his failed martial law ... [2998 chars]",
            "url": "https://www.bbc.com/news/articles/cy4qdpxp78po",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/ebb6/live/9780cef0-f1f8-11f0-9f40-09b9096d04b0.jpg",
            "publishedAt": "2026-01-16T05:26:32Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "033a1c53139b4e7dd7fac5a734c2bdf2",
            "title": "Mideast allies urged Trump to hold off on Iran strikes, diplomat says",
            "description": "Several Middle Eastern allies of the United States have urged the Trump administration to hold off on strikes against Iran for the government’s deadly crackdown on protesters.",
            "content": "WASHINGTON (AP) — Several Middle Eastern allies of the United States have urged the Trump administration to hold off on strikes against Iran for the government’s deadly crackdown on protesters, according to an Arab diplomat familiar with the matter.\n... [5008 chars]",
            "url": "https://apnews.com/article/trump-iran-middle-east-allies-strikes-diplomat-24f75a6b2ab3716be47163fcb0817bc7",
            "image": "https://dims.apnews.com/dims4/default/67db41e/2147483647/strip/true/crop/5536x3114+0+288/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fd4%2F9f%2F90a7e9507d855f50ea3563a61bac%2F8827ce5bad424859b3d9789516cdbedc",
            "publishedAt": "2026-01-16T04:01:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "095e24505a0352b2134437b144f5d505",
            "title": "How Activists in Iran Are Using Starlink to Stay Online",
            "description": "Activists spent years preparing for a communications blackout in Iran, smuggling in Starlink satellite internet systems and making digital shutdowns harder for the authorities to enforce.",
            "content": "Iran’s communications blackout last week seemed complete. Internet and cellular networks had been shut down by the authorities. Online banking, shopping and text messaging services stopped working. Information about the growing protests was scarce.\nY... [2076 chars]",
            "url": "https://www.nytimes.com/2026/01/15/technology/iran-online-starlink.html",
            "image": "https://static01.nyt.com/images/2026/01/15/multimedia/00biz-iran-internet-starlink-hgjm/00biz-iran-internet-starlink-hgjm-facebookJumbo-v2.jpg",
            "publishedAt": "2026-01-16T01:08:49Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories