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": 231660,
    "articles": [
        {
            "id": "ce7e44fc86f53941c895b27df6547ea3",
            "title": "WHO declares international emergency over Ebola outbreak",
            "description": "The World Health Organization said the Ebola outbreak could be much larger than what is currently being detected and reported. It warned of health risks to other countries.",
            "content": "The World Health Organization (WHO) on Sunday declared an Ebola outbreak in the Democratic Republic of Congo (DRC) and Uganda ⁠a \"public ⁠health emergency of international concern.\"\nThe WHO said the outbreak does not meet the criteria of a pandemic e... [2389 chars]",
            "url": "https://www.dw.com/en/who-declares-international-emergency-over-ebola-outbreak/a-77184899",
            "image": "https://static.dw.com/image/61569991_6.jpg",
            "publishedAt": "2026-05-17T10:41:15Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "dw.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "48ef432cedf8bd8faa2180a7087d7992",
            "title": "In Iraqi Desert, Two Israeli Outposts Were Kept Secret for Months",
            "description": "Israel spent over a year preparing a covert site in Iraq for its operations against Iran, regional officials say. Iraqi officials later confirmed the existence of a second base.",
            "content": "The truck rattling by at 2 p.m. on March 3 was a familiar sight to residents of the Bedouin encampment in Iraq’s rugged western desert — a local shepherd’s pickup, en route to the nearest town of al-Nukhaib.\nIts return a few hours later, flaming and ... [1284 chars]",
            "url": "https://www.nytimes.com/2026/05/17/world/europe/israel-iraq-iran-bases.html",
            "image": "https://static01.nyt.com/images/2026/05/14/multimedia/00int-iraq-israel-base-01-vqlz/00int-iraq-israel-base-01-vqlz-facebookJumbo.jpg",
            "publishedAt": "2026-05-17T10:14:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "92e9aeacd13aae7705c20819981a90fb",
            "title": "Why Uyghurs fought in Syria",
            "description": "Thousands of Uyghurs became key fighters against Syria's Assad regime. For the first time, they agreed to be interviewed. NPR spent weeks with some of them to understand why they fled China for Syria.",
            "content": "JISR AL-SHUGHUR, Syria — The plan was daring: Under cover of night, an elite group of forces would ambush Syrian government soldiers and cut off strategic supply lines supporting the regime-held northern city of Aleppo.\nFor months, the fighters had b... [23782 chars]",
            "url": "https://www.npr.org/2026/05/17/g-s1-113270/uyghurs-china-syria-war-fighters-rebels-bashar-al-assad",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/6000x3375+0+313/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F8c%2Fe9%2F716bc5484e58844267d8c853f3c4%2Fcopy-of-r0000347.JPG",
            "publishedAt": "2026-05-17T09:02:00Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories