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": 250854,
    "articles": [
        {
            "id": "d1d8d76f552b20e100d8e620842e939f",
            "title": "Germany loses vote for UN Security Council seat",
            "description": "Fifteen of the 193 UN member states sit on the UN Security Council. Germany was in competition with Austria and Portugal for two seats in the \"Western Europe and Others\" group.",
            "content": "Germany lost a vote on Wednesday for a temporary seat on the United Nations Security Council (UNSC).\nSpeaking to the press after the vote, Germany's Foreign Minister Johann Wadephul called the outcome \"a real disappointment.\"\nGermany loses out to Aus... [2538 chars]",
            "url": "https://www.dw.com/en/un-security-council-germany-temporary-seat-vote/a-77409955",
            "image": "https://static.dw.com/image/77410270_6.jpg",
            "publishedAt": "2026-06-03T16:52:30Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "45853274779c309568fa166fe639469a",
            "title": "Germany news: Naturalizations reach record high in 2025",
            "description": "Naturalizations have increased for the fifth year in a row. Automotive industry firms turn a bit less pessimistic. And Germany is aiming for a seat on the UN Security Council. Follow DW for more news from Germany.",
            "content": "Live\nPoliticsGermany\nGermany news: Naturalizations reach record high in 2025\nSean Sinico with AP, AFP, dpa, Reuters\nPublished 06/03/2026Published June 3, 2026\nNaturalizations have increased for the fifth year in a row. Automotive industry firms turn ... [23676 chars]",
            "url": "https://www.dw.com/en/germany-news-naturalizations-reach-record-high-in-2025/live-77400790",
            "image": "https://static.dw.com/image/69043224_6.jpg",
            "publishedAt": "2026-06-03T14:25:04Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "92808b132cf0da654c5d90735502e327",
            "title": "Fire tears through hotel in India's capital in Delhi, killing at least 21 people as some jump from windows",
            "description": "The fire started in the ground floor restaurant of an India hotel popular with patients at a nearby healthcare facility.",
            "content": "New Delhi - At least 21 people were killed by a fire that tore through a hotel in India's capital city on Wednesday morning, police said.\nThe fire started around 8:50 a.m. local time (about 11 p.m. Eastern on Tuesday) in the ground floor restaurant o... [2073 chars]",
            "url": "https://www.cbsnews.com/news/india-delhi-hotel-fire-death-toll/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/06/03/aab32c8c-ea77-4a52-800f-5c2268c18b1e/thumbnail/1200x630/d9091d726ed03772b6d01877d97bfedb/gettyimages-2278869923.jpg",
            "publishedAt": "2026-06-03T13:29:40Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories