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": 255840,
    "articles": [
        {
            "id": "6188b691f5c0031b03a700d9a72494f5",
            "title": "Hundreds evacuated as waves batter New Zealand capital",
            "description": "Authorities evacuated hundreds of people from their seaside homes in New Zealand's capital on Tuesday as 11-metre (36-foot) waves lashed the coast.Waves entering Wellington Harbour on Tuesday were mea...",
            "content": "Authorities evacuated hundreds of people from their seaside homes in New Zealand's capital on Tuesday as 11-metre (36-foot) waves lashed the coast.\nWellington Mayor Andrew Little declared a state of emergency on the eve of the swells for seaside resi... [1193 chars]",
            "url": "https://www.yahoo.com/news/weather-news/articles/hundreds-evacuated-waves-batter-zealand-014952120.html",
            "image": "https://s.yimg.com/lo/mysterio/api/69aa22ee7c04db3a8784e827287cc4fbb6fe8e57abd278bf52991b6e598e02fa/lightyear_networkapi/resizefill_w768_h512;quality_80;format_webp/https:%2F%2Fmedia.zenfs.com%2Fen%2Fafp.com%2F511849a0a523255319619392ed3f5455",
            "publishedAt": "2026-06-09T01:49:00Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        },
        {
            "id": "329b669665ab14edfcb28edf51ccb60f",
            "title": "NATO shoots down drone over Latvia as concern about Ukraine war’s spread grows",
            "description": "The drone, which entered Latvia from Russia, was the latest to violate the airspace of a NATO member during the war.",
            "content": "The drone, which entered Latvia from Russia, was the latest to violate the airspace of a NATO member during the war.\nJune 8, 2026 at 4:34 p.m. EDTYesterday at 4:34 p.m. EDT\nA French fighter jet shot down a drone that entered NATO ally Latvia’s airspa... [444 chars]",
            "url": "https://www.washingtonpost.com/world/2026/06/08/nato-shoots-down-drone-over-latvia-concern-about-ukraine-wars-spread-grows/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/J6MVHZG5E57QWDMJYETG4XRDME.JPG&w=1440",
            "publishedAt": "2026-06-09T01:06:55Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "71feda96345473bda15ffc665b6ef76c",
            "title": "Russia's fuel crisis intensifies as Ukraine steps up strikes on occupied territories",
            "description": "Kyiv has made it difficult for Moscow to provide military and civilian supplies to the territories it occupies.",
            "content": "Ukraine's sustained campaign of drone attacks on Russian-occupied territories is disrupting Moscow's supply lines and intensifying a fuel crisis already triggered by long-range strikes on Russia's oil refineries.\nCrimea - which Russia illegally annex... [5812 chars]",
            "url": "https://www.bbc.com/news/articles/cn75l36vdd8o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/d15c/live/a02730a0-635c-11f1-8e1d-bbbb1017d210.jpg",
            "publishedAt": "2026-06-08T23:23:15Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories