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": 247080,
    "articles": [
        {
            "id": "f2b3437cdc6c0214f1985c1fe192bb1b",
            "title": "Russian Refinery in Ryazan Catches Fire After Drone Attack",
            "description": "The overnight strike followed a separate drone attack that disrupted operations at Gazprom’s Astrakhan gas plant.",
            "content": "A large-scale drone attack overnight ignited a major fire at the Ryazan Oil Refinery, one of Russia’s largest fuel production facilities, according to local residents and Russian monitoring channels.\nMultiple loud explosions were reported after sever... [1423 chars]",
            "url": "https://www.kyivpost.com/post/76168",
            "image": "https://static.kyivpost.com/storage/2026/05/05/81f258e3f232774154870e63d1b6822c.png?w=1200&q=90&f=jpg",
            "publishedAt": "2026-05-15T06:27:00Z",
            "lang": "en",
            "source": {
                "id": "02c887af92e2e2e697e74bf65abd5a9b",
                "name": "Kyiv Post",
                "url": "https://www.kyivpost.com"
            }
        },
        {
            "id": "39dfa484654cf40caaed54483df67680",
            "title": "Aging Palestinian Leader Boosting His Son’s Political Rise, Officials Say",
            "description": "Mahmoud Abbas’s years in power have been dogged by accusations of corruption. Many Palestinians yearn for fresh leadership.",
            "content": "For years, the president of the Palestinian Authority, Mahmoud Abbas, has held an iron grip on power by ousting rivals, sidelining the judiciary and cooperating with Israel on security.\nMr. Abbas, 90, has now found another way to extend his influence... [1444 chars]",
            "url": "https://www.nytimes.com/2026/05/15/world/middleeast/abbas-fatah-palestinian-authority.html",
            "image": "https://static01.nyt.com/images/2026/05/14/multimedia/00int-westbank-abbas01-photo-cjgh/00int-westbank-abbas01-photo-cjgh-facebookJumbo.jpg",
            "publishedAt": "2026-05-15T04:01:19Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "74dc5624dab727e9b2cc49b1c85c2c62",
            "title": "Enter the Killer Robots: The Ukrainian Forging the Future of Warfare",
            "description": "Mykhailo Fedorov, Ukraine’s 35-year-old defense minister, sees futuristic military technology as crucial to his country’s survival.",
            "content": "As Ukraine’s 35-year-old defense minister strolled about in tennis shoes, jeans and a fleece, gazing at displays of his country’s latest crop of oddball weapons, he paused to eye one gigantic, ungainly new device.\nIt was a drone with muscular carbon ... [1341 chars]",
            "url": "https://www.nytimes.com/2026/05/15/world/europe/mykhailo-fedorov-ukraine-ai.html",
            "image": "https://static01.nyt.com/images/2026/05/15/multimedia/15int-ukraine-fedorov-profile-02-qmbc-promo/15int-ukraine-fedorov-profile-02-qmbc-promo-facebookJumbo.jpg",
            "publishedAt": "2026-05-15T04:01:10Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories