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": 206700,
    "articles": [
        {
            "id": "8dd0f7a0c0d2f366f62310215a553889",
            "title": "Israel launches 'large-scale operation' to locate last hostage in Gaza",
            "description": "Israel says its military is conducting a large-scale operation to locate the last hostage in Gaza. This comes as Washington and other mediators pressure Israel and Hamas to move into the next phase of their ceasefire.",
            "content": "NAHARIYA, Israel (AP) — Israel said Sunday its military was conducting a “large-scale operation” to locate the last hostage in Gaza, as Washington and other mediators pressure Israel and Hamas to move into the next phase of their ceasefire.\nThe state... [3884 chars]",
            "url": "https://apnews.com/article/gaza-israel-hamas-palestinians-hostage-gvili-d57a28eb5371785588d4b955f9dd2a46",
            "image": "https://dims.apnews.com/dims4/default/b7c209a/2147483647/strip/true/crop/8067x5375+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ff4%2F5e%2Fac5591763b9474be4cd34ccc189a%2F9b5d60d16e00445ca24eed4c4ca17a55",
            "publishedAt": "2026-01-25T22:36:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "3926cd95898cc2a51acd7f99d370ba0a",
            "title": "China's Ambitious Man-Made Island Now 'a Dead Zone'",
            "description": "On a ring of artificial islands off China's southern coast, the boom years live on as a very expensive mirage. Ocean Flower Island, a $12 billion Evergrande showpiece modeled...",
            "content": "On a ring of artificial islands off China's southern coast, the boom years live on as a very expensive mirage. Ocean Flower Island, a $12 billion Evergrande showpiece modeled loosely on Dubai's Palm Jumeirah, was supposed to host 200,000 residents pl... [2016 chars]",
            "url": "https://www.newser.com/story/382240/chinas-man-made-island-still-chases-real-estate-redemption.html",
            "image": "https://img1-azrcdn.newser.com/image/1659830-12-20260125151332.jpeg",
            "publishedAt": "2026-01-25T20:54:00Z",
            "lang": "en",
            "source": {
                "id": "f22037146197b1382cc938771f7d78b3",
                "name": "Newser",
                "url": "https://www.newser.com"
            }
        },
        {
            "id": "314e717017b53125c9917c8679706212",
            "title": "Trump causes flap with AI image of 'Greenland penguin'",
            "description": "White House posts picture of US president walking with flightless bird, but social media users quickly point out they only live in southern hemisphere",
            "content": "The White House got a cold reception when it posted an artificial intelligence-generated image of US President Donald Trump walking with a penguin — in Greenland.\nSocial media users were quick to point out that penguins almost exclusively live in the... [2023 chars]",
            "url": "https://www.timesofisrael.com/trump-causes-flap-with-ai-image-of-greenland-penguin/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/01/AP26023096879479-e1769369428243.jpg",
            "publishedAt": "2026-01-25T20:40:33Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "timesofisrael.com",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories