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": 226604,
    "articles": [
        {
            "id": "88aa3810d289ef83807d9a9eae4fa7b8",
            "title": "Hamas commander who helped plan Oct. 7 attacks has been killed, Israel says",
            "description": "Izz al-Din al-Haddad was killed in a \"precise strike in the area on the City of Gaza,\" the Israel Defense Forces said Saturday.",
            "content": "A long-serving Hamas commander who replaced Mohammed Sinwar and helped plan the Oct. 7 attacks in Israel was killed on Friday, Israeli officials said Saturday.\nIzz al-Din al-Haddad was the head of Hamas' military wing, the Israel Defense Forces said ... [1246 chars]",
            "url": "https://www.cbsnews.com/news/izz-al-din-al-haddad-hamas-commander-killed-gaza-hamas-israel/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/05/16/4915cab3-d6e5-461a-9da4-14a6db2e41cd/thumbnail/1200x630/1dbfb843d72dc80db2c92effa0e9a616/screenshot-2026-05-16-at-6-41-54-am.png",
            "publishedAt": "2026-05-16T10:32:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "0d2e40a24fa48f36d036a0171040b108",
            "title": "US stops Poland troop deployment after Germany pullout order",
            "description": "Both Democratic and Republican lawmakers in the US have criticized the Trump administration's plans to cancel a troop deployment to Poland. It came after Trump ordered the pullout of 5,000 troops from Germany.",
            "content": "The Pentagon said it is halting the deployment of 4,000 troops to Poland, according to US officials, after President Donald Trump's administration said it would pull out thousands of soldiers in Germany.\nThe 4,000 troops in question belong to the Arm... [2616 chars]",
            "url": "https://www.dw.com/en/us-stops-poland-troop-deployment-after-germany-pullout-order/a-77177920",
            "image": "https://static.dw.com/image/77127778_6.jpg",
            "publishedAt": "2026-05-16T09:41:55Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "7b9473623875aff0b0bbde703d087fd9",
            "title": "They Fled to Safety in Palestinian Territory, Then Settlers Attacked Again",
            "description": "Violent settlers are not merely clearing Palestinians from land under Israel’s control. They are attacking areas where Israel agreed to Palestinian self-governance.",
            "content": "Muhammad Gawanmeh recognized the black pickup when it first pulled in front of his tent, trailed by an ATV carrying Israeli settlers he also recognized.\nIn January, he had fled his home of more than 40 years in the Israeli-occupied West Bank after vi... [747 chars]",
            "url": "https://www.nytimes.com/2026/05/16/world/middleeast/settler-attacks-palestinians-west-bank.html",
            "image": "https://static01.nyt.com/images/2026/05/12/multimedia/12int-israel-westbank-lpqf-promo/12int-israel-westbank-lpqf-facebookJumbo.jpg",
            "publishedAt": "2026-05-16T09:06:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories