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": 238510,
    "articles": [
        {
            "id": "8835baf72b0ef0cb220cebd63899a148",
            "title": "Live updates: Iran war news, attacks on ships in Strait of Hormuz escalate, as Tehran launches ‘intense’ strikes",
            "description": "Overnight Iranian attacks come as Israel unleashes new bombardment of Tehran and US targets Iran’s navy near the Strait of Hormuz. Follow for live updates",
            "content": "US military vehicles seen on the move in South Korea\n00:40 • Source: CNN\nUS military vehicles seen on the move in South Korea\n00:40\nVideo obtained by CNN show US military vehicles known to transport a key missile interceptor system on the move in Sou... [14592 chars]",
            "url": "https://www.cnn.com/world/live-news/iran-war-us-israel-trump-03-11-26",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2265273047.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-11T08:55:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "eb5799a08d13ad6b6af06bcb0682ede0",
            "title": "Swiss police probe if deadly bus fire was 'deliberate act'",
            "description": "A bus fire in the Swiss town of Kerzers killed at least six people and injured several others. Investigators say early indications point to a possible deliberate act.",
            "content": "Police are investigating whether a deliberate act caused a bus fire in western Switzerland that killed at least six people and injured several others on Tuesday.\nThe bus caught fire around 6:25 p.m. on the main street of Kerzers, in the canton of Fri... [1330 chars]",
            "url": "https://www.dw.com/en/swiss-police-probe-if-deadly-bus-fire-was-deliberate-act/a-76298422",
            "image": "https://static.dw.com/image/76298029_6.jpg",
            "publishedAt": "2026-03-11T08:45:41Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "103c33554798b5535cf05e947af1ed94",
            "title": "Iran’s new supreme leader was injured in legs on 1st day of war - report",
            "description": "New York Times says Mojtaba Khamenei was hurt in US-Israeli strikes; son of Iranian president Pezeshkian insists he is 'safe and sound'",
            "content": "Iran’s new supreme leader, Mojtaba Khamenei, was wounded in his legs on the opening day of US-Israeli strikes on Iran, The New York Times reported Wednesday, citing Israeli and Iranian officials.\nKhamenei, 56, was announced on Sunday as the successor... [2280 chars]",
            "url": "https://www.timesofisrael.com/irans-new-supreme-leader-was-injured-in-legs-on-1st-day-of-war-report/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/03/vlcsnap-2026-03-08-18h46m57s671-copy.jpg",
            "publishedAt": "2026-03-11T08:37:04Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories