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": 236768,
    "articles": [
        {
            "id": "aeb727d24b6b1e6c70b180662664cc4f",
            "title": "UK faces cyberattacks from Russia, Iran, and China, warns NCSC head",
            "description": "The head of the U.K.'s National Cyber Security Centre warns that hostile nations like Russia, Iran and China are behind the most serious cyberattacks in the U.K.",
            "content": "GLASGOW, Scotland (AP) — The most serious cyberattacks in the U.K. are now carried out by hostile nations including Russia, Iran and China, the head of the U.K.’s National Cyber Security Centre (NCSC) said in a speech Wednesday.\nRichard Horne, the he... [4592 chars]",
            "url": "https://apnews.com/article/russia-iran-china-uk-cyber-defense-5fcdc5eaf14b2d016c2575bbdab47c39",
            "image": "https://dims.apnews.com/dims4/default/42a5860/2147483647/strip/true/crop/7391x4925+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fef%2Fc0%2F334eeecb0c49e129d5b29a28b852%2F508b3035768541a4ad3d7f2f50ab2370",
            "publishedAt": "2026-04-22T12:03:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "852e68f73a8cff32711022b742bdce48",
            "title": "UK bill bans anyone born after 2008 from ever buying tobacco",
            "description": "People who are now 17 or younger will never be able to buy tobacco, according to the law backed by the UK Parliament.",
            "content": "A new bill approved in the United Kingdom’s legislature will stop people born on or after January 1, 2009 from buying tobacco during their whole lives, as part of a years-long effort by ministers to create a “smoke-free generation”.\nSecretary of Stat... [2710 chars]",
            "url": "https://www.aljazeera.com/news/2026/4/22/new-uk-bill-bans-anyone-born-after-2008-from-buying-tobacco",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/04/getty_69e89b4d44-1776851789.jpg?resize=1920%2C1440",
            "publishedAt": "2026-04-22T10:55:23Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "d970821e5f3fb26165b8db0cc3e16b08",
            "title": "Live updates: Iran attacks 3 ships in the Strait of Hormuz as Trump indefinitely extends ceasefire",
            "description": "Iran attacks 3 ships in the Strait of Hormuz, as Trump indefinitely extends ceasefire",
            "content": "The European Union’s top energy official is warning that the massive energy crisis sparked by the U.S.-Israeli war on Iran is set to hit prices for months, even years, to come.\nEU Energy Commissioner Dan Jørgensen said Wednesday that “this is not a s... [11348 chars]",
            "url": "https://apnews.com/live/iran-war-israel-trump-04-22-2026",
            "image": "https://dims.apnews.com/dims4/default/ba681a3/2147483647/strip/true/crop/4712x3140+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F83%2Ff2%2F6eb459de4d319fa118a98c94767c%2Fap26111247220555.jpg",
            "publishedAt": "2026-04-22T10:06:55Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories