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": 225982,
    "articles": [
        {
            "id": "805691abfd41eb1b681aa89b8beead6f",
            "title": "Lagarde Calls Bessent Out on Iran Damage During G-7 Video Talks",
            "description": "Christine Lagarde used an audience of high-level Group of Seven officials to challenge Treasury Secretary Scott Bessent’s optimism that the Iran war’s economic fallout will be short-lived, according to people familiar with the matter.",
            "content": "Connecting decision makers to a dynamic network of information, people and ideas, Bloomberg quickly and accurately delivers business and financial information, news and insight around the world\nConnecting decision makers to a dynamic network of infor... [638 chars]",
            "url": "https://www.bloomberg.com/news/articles/2026-03-31/lagarde-calls-bessent-out-on-iran-damage-during-g-7-video-talks",
            "image": "https://assets.bwbx.io/images/users/iqjWHBFdfxIU/iAmScoVslYeU/v0/1200x800.jpg",
            "publishedAt": "2026-03-31T13:45:24Z",
            "lang": "en",
            "source": {
                "id": "35303254fdf42d2f3365eadb3d9d8a17",
                "name": "Bloomberg.com",
                "url": "https://www.bloomberg.com"
            }
        },
        {
            "id": "ed3ae7c3c440bb2bd624542d09d1dd3b",
            "title": "Russia slowly trying to splinter its internet from rest of world, analysts say",
            "description": "Telegram is increasingly blocked and mobile internet users face blackouts in effort likened to Iranian shutdowns",
            "content": "Russia is in the midst of a vast, slow-moving effort to splinter its internet from the rest of the world, say activists and experts, with steep consequences for millions of people who are gradually being cut off.\nUnlike Iran’s internet shutdowns earl... [3879 chars]",
            "url": "https://www.theguardian.com/world/2026/mar/31/russia-splinter-internet-blackouts-telegram-analysts",
            "image": "https://i.guim.co.uk/img/media/ec1551ce1f98c80159a91f6b62279f574d65586e/603_0_6880_5504/master/6880.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=ac2c66f10acc5c74b59bbc03c368558f",
            "publishedAt": "2026-03-31T13:19:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "f692875e0cae3c2108eec2e6cadbd773",
            "title": "Whale stranded again off Germany's Baltic coast",
            "description": "A humpback whale that has become stranded repeatedly off Germany’s Baltic Sea coast in recent days has got stuck again, less than a day after swimming free.",
            "content": "BERLIN (AP) — A humpback whale that has become stranded repeatedly off Germany’s Baltic Sea coast in recent days got stuck again on Tuesday, authorities said, less than a day after swimming free. But rescuers were hopeful that it could still find its... [2562 chars]",
            "url": "https://apnews.com/article/germany-humpback-whale-stranded-rescue-d561dd4685297fac46a7c45397791b5c",
            "image": "https://dims.apnews.com/dims4/default/9ec8d9a/2147483647/strip/true/crop/5640x3758+521+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F6d%2Fdc%2F4dd8d4bfdbfb9e37cd1c3078032a%2F21f124526f2c4ee1926ef42aaba6ad0c",
            "publishedAt": "2026-03-31T13:09:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories