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": 231424,
    "articles": [
        {
            "id": "b6ee687fcee51385041d203038251ea4",
            "title": "Europe Prepares for a Longer War in Ukraine, With No Strategy to End It",
            "description": "With American dealmakers wrapped up with Iran, neither Russia nor Ukraine has a clear path to victory — or toward a negotiated peace.",
            "content": "With President Trump and his team preoccupied with the war in Iran, Europe is preparing for a longer war in Ukraine, with dwindling expectations for a negotiated settlement between Moscow and Kyiv.\nThat leaves Ukraine largely on its own, fighting a w... [1237 chars]",
            "url": "https://www.nytimes.com/2026/04/25/world/europe/ukraine-russia-europe-european-union.html",
            "image": "https://static01.nyt.com/images/2026/04/25/multimedia/25int-ukraine-europe-adrift-assess-mhzt/25int-ukraine-europe-adrift-assess-mhzt-facebookJumbo.jpg",
            "publishedAt": "2026-04-25T09:02:31Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "1c2d42729a85b19375d788aeeb6d2b6c",
            "title": "Palestinians in West Bank and some in Gaza vote in local elections",
            "description": "Local elections are held in the occupied West Bank and in one Gazan city, though Hamas and other groups are not taking part.",
            "content": "Palestinians are voting in local elections on Saturday, including the first poll of any kind to be held in Gaza since 2006.\nElections are taking place across the occupied West Bank, as well as in Deir al-Balah in central Gaza where Hamas operates.\nHa... [3855 chars]",
            "url": "https://www.bbc.com/news/articles/cn4vej3x0wxo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/0fc6/live/17495f90-4072-11f1-83f8-e39ccdeebf3b.jpg",
            "publishedAt": "2026-04-25T08:53:15Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "3635067dfa2955174c8e0cd65cd28127",
            "title": "Palestinian Authority local elections start for first time in years",
            "description": "The elections, the first of their kind since the October 7 massacre in 2023, will be held in the West Bank and the Gazan city of Deir al-Balah.",
            "content": "Palestinian elections for the local council of the Palestinian Authority opened up their polls on Saturday, with 1 million Palestinians expected to vote - including 70,000 from Gaza.\nThe polls will close by 7 p.m., with the first results expected by ... [1648 chars]",
            "url": "https://www.jpost.com/middle-east/article-894096",
            "image": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/717764",
            "publishedAt": "2026-04-25T04:38:02Z",
            "lang": "en",
            "source": {
                "id": "78834c45a26f98bca295cc641123cf7f",
                "name": "The Jerusalem Post",
                "url": "https://www.jpost.com"
            }
        }
    ]
}

Categories