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": 241528,
    "articles": [
        {
            "id": "48100157abe062fe18e9071752ca2f5b",
            "title": "Who is Mojtaba Khamenei, Iran's new supreme leader?",
            "description": "Iran's Assembly of Experts has chosen Ali Khamenei's son Mojtaba as the country's new supreme leader. His selection shows that the Iranian regime, at war with the US and Israel, has opted for a confrontational path.",
            "content": "Mojtaba Khamenei, born on September 8, 1969, in Mashhad, is the second son of Ali Khamenei, Iran's former supreme leader, who was killed in an Israeli strike on February 28. An 88-member Assembly of Experts named him the Islamic Republic's new suprem... [4447 chars]",
            "url": "https://www.dw.com/en/who-is-mojtaba-khamenei-irans-new-supreme-leader/a-76271184",
            "image": "https://static.dw.com/image/76271597_6.jpg",
            "publishedAt": "2026-03-09T14:41:23Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "dw.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "a6d7c4dc3455262a90e00000bc082a2c",
            "title": "HMS Prince of Wales unlikely to head to the Middle East",
            "description": "It comes after defence sources said the crew had been told they must be ready to leave in five days.",
            "content": "HMS Prince of Wales, one of the UK's two aircraft carriers, is now unlikely to head to the Middle East as part of efforts to protect British interests, it is understood.\nThe carrier was placed on an advanced state of readiness on Saturday, meaning it... [2237 chars]",
            "url": "https://www.bbc.com/news/articles/c0mgyw32j8jo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/e7cb/live/00ea4560-1bc0-11f1-964c-87b629a369ca.jpg",
            "publishedAt": "2026-03-09T14:34:31Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "ed924f0241a5ef45e64d4fd83b23ba81",
            "title": "Trump says he's \"not happy\" about Iran's new supreme leader, Mojtaba Khamenei",
            "description": "Mojtaba Khamenei was named Iran's new supreme leader following the death of his father in the U.S.-Israeli strikes.",
            "content": "Washington — President Trump told Fox News that he's \"not happy\" with Iran's new supreme leader, Ayatollah Mojtaba Khamenei.\nKhamenei was named Iran's new leader over the weekend, according to Iranian state media, taking the place of his father, Ali ... [1506 chars]",
            "url": "https://www.cbsnews.com/news/trump-not-happy-iran-new-supreme-leader-mojtaba-khamenei/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/03/09/9cc4ff86-3e82-4899-9cde-493bfab08fb9/thumbnail/1200x630/93defa16e752fd63b93098365955abf1/ap26068456869895.jpg",
            "publishedAt": "2026-03-09T14:08:08Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories