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": 238304,
    "articles": [
        {
            "id": "97db5982a65de43d66be916e24c3e92a",
            "title": "Death toll after train crash near Indonesia’s Jakarta rises to 14",
            "description": "The head of the national rescue agency says efforts continue to remove people trapped in wreckage.",
            "content": "⁠Fourteen people have been confirmed killed and more than 80 injured in a collision involving two trains near the Indonesian capital, Jakarta, with rescue workers continuing efforts to free passengers trapped in the wreckage.\nThe crash late on Monday... [2237 chars]",
            "url": "https://www.aljazeera.com/news/2026/4/28/five-killed-in-train-crash-near-indonesias-jakarta-rescue-efforts-ongoing",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/04/2026-04-27T201335Z_915219847_RC2VXKAF0KNY_RTRMADP_3_INDONESIA-TRAINS-1777336772.jpg?resize=1920%2C1440",
            "publishedAt": "2026-04-28T04:52:30Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "908c186194e891c6145f53df9c5056d3",
            "title": "IS claims responsibility for Nigeria attack that killed 29 people",
            "description": "Authorities say the militants raided a football pitch where people had been gathering and opened fire at random.",
            "content": "Gunmen have killed at least 29 people in an attack on a village in Nigeria's north-eastern Adamawa state, local officials say.\nThe Islamic State group (IS) has claimed responsibility for the attack, without specifying its motive.\nAuthorities and loca... [1385 chars]",
            "url": "https://www.bbc.com/news/articles/c62d43vdgmmo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/2843/live/d3f99380-42a2-11f1-b55d-0f258dce1735.jpg",
            "publishedAt": "2026-04-28T03:28:48Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "35c524da76fdaa158ae797ba975a7de8",
            "title": "Trump Is Dissatisfied With Iran’s Plan to Reopen Strait of Hormuz",
            "description": "The proposal would have set aside questions about what to do with Iran’s nuclear program.",
            "content": "President Trump has told advisers he is not satisfied with Iran’s latest proposal to reopen the Strait of Hormuz and end the war, according to multiple people briefed on discussions in the White House Situation Room on Monday.\nThe proposal also calle... [1263 chars]",
            "url": "https://www.nytimes.com/2026/04/27/us/trump-iran-proposal.html",
            "image": "https://static01.nyt.com/images/2026/04/27/multimedia/27dc-diplo-iran-gkpm/27dc-diplo-iran-gkpm-facebookJumbo.jpg",
            "publishedAt": "2026-04-28T03:00:31Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories