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": 202846,
    "articles": [
        {
            "id": "e8926b1fe21cc9a996af1c7174a888cd",
            "title": "Ukraine is battling to keep the lights on",
            "description": "The BBC gains rare access to the Khmelnytsky plant as Russian pummels Ukraine's energy grid.",
            "content": "Ukraine is battling to keep the lights on, this nuclear plant is vital in the fight\n5 hours ago\nWrye DaviesKhmelnytsky nuclear plant, western Ukraine\nA handful of technicians closely monitor a wall of screens and dial in the control room at the Khmel... [8298 chars]",
            "url": "https://www.bbc.com/news/articles/cp3zzqzgn28o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/4778/live/e55cc960-f790-11f0-9b64-a73fe49a8bb9.jpg",
            "publishedAt": "2026-01-23T05:57:55Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "4db6aceb4d088ac010b81a7e7bcb88af",
            "title": "Japan's Takaichi dissolves parliament, setting up February snap election",
            "description": "Japan’s Prime Minister Sanae Takaichi has dissolved the lower house of Parliament, paving the way for a Feb. 8 snap election.",
            "content": "TOKYO (AP) — Japan’s Prime Minister Sanae Takaichi dissolved the lower house of Parliament on Friday, paving the way for a Feb. 8 snap election.\nThe move is an attempt to capitalize on her popularity to help governing party regain ground after major ... [2714 chars]",
            "url": "https://apnews.com/article/japan-politics-takaichi-parliament-dissolution-election-74e9b32eb12a6f9823242255b92150b2",
            "image": "https://dims.apnews.com/dims4/default/7595f4d/2147483647/strip/true/crop/5000x3332+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F90%2F01%2Ff62baac5347d1a55a56a41770b84%2F168ca89ff8d64acf9331551386cb44c6",
            "publishedAt": "2026-01-23T04:40:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "c32e0e9ed02ac0c4c84b0c2178bf4731",
            "title": "Despite concerns, PM's reliance on Trump left him no choice but to join Board of Peace",
            "description": "Israeli official tells ToI that Jerusalem in principle supports US-led Gaza oversight panel, but has major qualms with makeup of board that it 'isn't well positioned' to address",
            "content": "Prime Minister Benjamin Netanyahu’s reliance on US President Donald Trump left the Israeli premier with little choice but to accept an invitation to join the Board of Peace, despite significant qualms regarding the makeup of the panel’s Gaza Executiv... [4385 chars]",
            "url": "https://www.timesofisrael.com/despite-concerns-pms-reliance-on-trump-left-him-no-choice-but-to-join-board-of-peace/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/01/AFP__20251229__899A8MG__v1__HighRes__IsraeliPmBenjaminNetanyahuVisits.jpg",
            "publishedAt": "2026-01-23T03:45:09Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "timesofisrael.com",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories