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": 237940,
    "articles": [
        {
            "id": "944eb638b02c4fedfb7b3c585dc21031",
            "title": "US to withdraw 5,000 troops from Germany in next 6-12 months",
            "description": "The Pentagon says the United States will withdraw about 5,000 troops from Germany in the next six to 12 months.",
            "content": "WASHINGTON (AP) — The United States will withdraw about 5,000 troops from Germany in the next six to 12 months, the Pentagon said Friday, fulfilling President Donald Trump’s threat as he clashes with the German leader over the U.S. war with Iran.\nTru... [3848 chars]",
            "url": "https://apnews.com/article/trump-merz-germany-troops-withdrawal-nato-d37af7bcd1a97e265f3b3afd8aa65142",
            "image": "https://dims.apnews.com/dims4/default/7c0ce3b/2147483647/strip/true/crop/6993x4660+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fea%2Ff7%2Fe6bcd95260c899a60a5e0b0c1151%2Ff876917ecaba4c94b1556b936cf37c14",
            "publishedAt": "2026-05-01T23:59:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "708af5aa8577fd52142c5e6e5591b0e0",
            "title": "U.S. to Withdraw 5,000 Troops From Germany, Pentagon Says",
            "description": "Officials announced the decision after President Trump expressed annoyance with the German chancellor’s remarks about the Iran war.",
            "content": "Pentagon officials said on Friday that they were pulling 5,000 troops from Germany and would redeploy them to the United States and other posts overseas.\nThe Defense Department is also canceling a plan developed under the Biden administration to plac... [1264 chars]",
            "url": "https://www.nytimes.com/2026/05/01/us/politics/us-troops-germany.html",
            "image": "https://static01.nyt.com/images/2026/05/01/multimedia/01dc-military-germany-qgpk/01dc-military-germany-qgpk-facebookJumbo.jpg",
            "publishedAt": "2026-05-01T23:38:50Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "d3f41fa28623ec72bfc73d3de9f5602a",
            "title": "Rebel checkpoints reported around Mali’s capital, northern town seized",
            "description": "JNIM and Tuareg separatists continue their attacks against Mali’s military government.",
            "content": "Al-Qaeda-linked rebel fighters have reportedly set up checkpoints around Mali’s capital, Bamako, and seized the town of Tessalit in the north.\nReuters reported on Friday that Jamaat Nusrat al-Islam wal-Muslimin (JNIM) has called on Malians to rise up... [2499 chars]",
            "url": "https://www.aljazeera.com/news/2026/5/1/rebel-checkpoints-reported-mali-capital-town-seized",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/05/reuters_69f4ec53-1777658963.jpg?resize=1200%2C675",
            "publishedAt": "2026-05-01T23:03:44Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        }
    ]
}

Categories