Flag of the 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": 3339424,
    "articles": [
        {
            "title": "Russia bombards Ukraine with 479 drones overnight, Ukrainian air force says",
            "description": "Russia launched a massive aerial attack, sending hundreds of drones to Ukraine.",
            "content": "Russian President Vladimir Putin chairs a meeting of the Council for strategic development and national projects in Moscow, Russia, Friday, June 6, 2025.\nRussian President Vladimir Putin chairs a meeting of the Council for strategic development and n... [1851 chars]",
            "url": "https://abcnews.go.com/International/polish-allied-planes-briefly-scramble-amid-russian-targeting/story?id=122644087",
            "image": "https://i.abcnewsfe.com/a/e8058dea-b68b-453a-a30c-501a640e2cbc/putin-main_1749459063330_hpMain_16x9.jpg?w=1600",
            "publishedAt": "2025-06-09T08:48:45Z",
            "source": {
                "name": "ABC News",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "title": "Israel Intercepts Gaza-Bound Aid Ship With Greta Thunberg Aboard",
            "description": "Israel had vowed to prevent the vessel from reaching Gaza, saying its military would use “any means necessary” to stop it from breaching a naval blockade.",
            "content": "The Israeli Foreign Ministry said early on Monday morning that a Gaza-bound ship carrying a dozen pro-Palestinian activists and some aid had been diverted toward Israeli shores and that its passengers were expected to return to their home countries.\n... [958 chars]",
            "url": "https://www.nytimes.com/2025/06/08/world/middleeast/gaza-flotilla-greta-thunberg-israel.html",
            "image": "https://static01.nyt.com/images/2025/07/08/multimedia/08int-israel-flotilla-gqbj-promo/08int-israel-flotilla-gqbj-promo-facebookJumbo.jpg",
            "publishedAt": "2025-06-09T08:43:00Z",
            "source": {
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "title": "4 Japanese soldiers are injured after an explosion at a US military base",
            "description": "Japanese officials say an explosion at a storage site for unexploded ordnances at a U.S. military base on Japan’s southern island of Okinawa injured four Japanese soldiers.",
            "content": "TOKYO (AP) — An explosion at a storage site for unexploded ordnances at a U.S. military base on Japan’s southern island of Okinawa injured four Japanese soldiers, though the injuries are not life threatening, officials said Monday.\nThe four soldiers ... [1399 chars]",
            "url": "https://apnews.com/article/japan-us-base-defense-explosion-kadena-fa4797118e44728555c155460ade8f4a",
            "image": "https://dims.apnews.com/dims4/default/5124410/2147483647/strip/true/crop/5000x2813+0+260/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc4%2Fe6%2F327d69627189b0e42781228c5211%2F718a5e33009b4a018ccabeeac57910b4",
            "publishedAt": "2025-06-09T07:55:00Z",
            "source": {
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories