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": 239080,
    "articles": [
        {
            "id": "55215ec0734e2628dd5a42e2d4b7363a",
            "title": "Bermuda welcomes King Charles with boats, dancing and cake-cutting",
            "description": "Schoolchildren turn out to meet the monarch, with exotic birds and Bob Marley music all part of the welcome.",
            "content": "King Charles III is visiting Bermuda on his first trip to a British overseas territory as monarch.\nThe King, who was not accompanied by Queen Camilla, arrived in the territory's capital of Hamilton on Thursday evening, after a four-day state visit to... [3684 chars]",
            "url": "https://www.bbc.com/news/articles/cvgz08k04jeo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/2bae/live/32d53960-459e-11f1-b55d-0f258dce1735.jpg",
            "publishedAt": "2026-05-02T06:55:48Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "e63d3a2f70aad066b5ec7b678e70ded0",
            "title": "US to withdraw thousands of troops from Germany",
            "description": "The decision to cut US troops comes amid rising tensions after German Chancellor Friedrich Merz said the US was being \"humiliated\" by Iran's leadership.",
            "content": "US Defense Secretary Pete Hegseth has ordered the withdrawal of around 5,000 American soldiers stationed in Germany, the Pentagon said on Friday.\nThe drawdown, which would cut US troop numbers in Germany by 14%, is to be completed over the next six t... [2953 chars]",
            "url": "https://www.dw.com/en/us-to-withdraw-thousands-of-troops-from-germany/a-77016071",
            "image": "https://static.dw.com/image/77016572_6.jpg",
            "publishedAt": "2026-05-02T05:34:56Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "84f323566d18d30101b0c7c57dbd28d6",
            "title": "Trump to downsize U.S. military presence in Germany",
            "description": "The decision coincides with a feud between the president and German Chancellor Friedrich Merz, who has criticized the U.S. war in Iran.",
            "content": "The decision coincides with a feud between the president and German Chancellor Friedrich Merz, who has criticized the U.S. war in Iran.\nUpdated\nMay 1, 2026 at 8:03 p.m. EDTtoday at 8:03 p.m. EDT\nThe Pentagon on Friday said that it is withdrawing abou... [375 chars]",
            "url": "https://www.washingtonpost.com/national-security/2026/05/01/us-troops-germany-trump-merz/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/PZF4G4XPYJTLSQFHCOWTBQDCHY.JPG&w=1440",
            "publishedAt": "2026-05-02T03:03:00Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories