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": 243408,
    "articles": [
        {
            "id": "c323753d9f1960266ac07f2c202a584b",
            "title": "Live updates Israel urges evacuation of Beirut’s southern suburbs; Iran threatens revenge over warship",
            "description": "Neighboring countries including Azerbaijan and Saudi Arabia reported fresh attacks, and Qatar said it was evacuating residents near the U.S. Embassy in Doha.",
            "content": "Regional war spirals: Israeli forces targeted Iran and Lebanon and retaliatory attacks from Iran continued to hit across the Persian Gulf and beyond, dragging more countries into the conflict. Two Iranian drones fell in Azerbaijan, its foreign minist... [1260 chars]",
            "url": "https://www.washingtonpost.com/world/2026/03/05/us-iran-israel-strikes-trump-live-updates/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/37ITQZ3ZMN66FWVJCBD2XN37CQ_size-normalized.jpg&w=1440",
            "publishedAt": "2026-03-05T15:25:20Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "fae25c18d71c84bcfeb5e700aaafb74a",
            "title": "Iran wants to ‘draw blood’ before talking to Trump",
            "description": "Iran doesn’t want to talk. It doesn’t want to parley. And it’s not sitting down with President Donald Trump. Here's what may be next in the Iran war.",
            "content": "Iran doesn’t want to talk. It doesn’t want to parley. And it’s not sitting down with President Donald Trump.\nEven as Iran endures devastating airstrikes, the country's surviving leaders have determined \"it has to really draw blood\" before negotiating... [9141 chars]",
            "url": "https://www.usatoday.com/story/news/world/2026/03/05/iran-air-war-us-talking-to-trump/88963540007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/03/03/USAT/88964315007-20260303-t-183817-z-2077216224-rc-20-xjath-5-u-5-rtrmadp-3-irancrisisemirates.JPG?crop=5711,3213,x0,y297&width=3200&height=1801&format=pjpg&auto=webp",
            "publishedAt": "2026-03-05T15:23:00Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        },
        {
            "id": "71e15739b2245f2cca3371aac962c62d",
            "title": "Sea levels much higher than previously thought due to \"methodological blind spot,\" study finds",
            "description": "A new study in the journal Nature says most sea level rise research may have underestimated coastal water heights by an average of 1 foot.",
            "content": "Rising sea levels caused by climate change may be significantly higher than previously thought, according to a new study, which says a \"methodological blind spot\" led researchers to underestimate existing coastal water levels. The revelation suggests... [5733 chars]",
            "url": "https://www.cbsnews.com/news/sea-levels-higher-methodological-blind-spot-study/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/03/05/444e8429-0841-4f72-98a1-3f98bd195c9c/thumbnail/1200x630/bdb1761bc87d59b7663d1576a94ddfef/ap26062831821680.jpg",
            "publishedAt": "2026-03-05T13:37:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories