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": 236076,
    "articles": [
        {
            "id": "a0dccdc0836ba8c518e1180833f1f1db",
            "title": "US air defenses may not be able to intercept many of Iran’s one-way drones",
            "description": "Trump administration officials told lawmakers during a closed-door briefing on Capitol Hill Tuesday that Iran’s Shahed attack drones represent a major challenge and US air defenses will not be able to intercept them all, according to a source in the briefing.",
            "content": "Trump administration officials told lawmakers during a closed-door briefing on Capitol Hill Tuesday that Iran’s Shahed attack drones represent a major challenge and US air defenses will not be able to intercept them all, according to a source in the ... [4348 chars]",
            "url": "https://www.cnn.com/2026/03/04/politics/us-air-defenses-iran-attack-drones-challenge",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2264630486.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-04T13:13:25Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "8c9f6c99169c9f00ebb28c2c3804612e",
            "title": "Middle East crisis live: US submarine sank Iranian warship, Hegseth confirms; Israel launches ‘wave of strikes’ on Tehran",
            "description": "Nearly 150 reported missing and 32 people from the 180-crew frigate Iris Dena",
            "content": "Key events\nShow key events only\nPlease turn on JavaScript to use this feature\nTell us: how have you been affected by the latest events in the Middle East?\nThe conflict in the Middle East has continued to escalate, with Israel announcing it had launch... [7107 chars]",
            "url": "https://www.theguardian.com/world/live/2026/mar/04/iran-war-live-updates-us-israel-latest-news-strait-of-hormuz-middle-east-crisis?page=with:block-69a802de8f083ffba587ccaf",
            "image": "https://i.guim.co.uk/img/media/5398b11a3f7349087aaf1c046642577324f3f1dd/675_0_5994_4797/master/5994.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=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=aff3f8bb8d91b48fc6b329d7e0f7c104",
            "publishedAt": "2026-03-04T13:07:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "ab92e4731f330ce9ce445689db03c525",
            "title": "Iran, Hezbollah slam Israel with coordinated attack",
            "description": "While Israeli media initially reported that the IDF had shot down a missile launched from Iran, sirens sounded moments later in the same areas due to a launch from Lebanon.",
            "content": "Iran and Hezbollah sent waves of projectiles to central and northern Israel in a coordinated attack on Wednesday afternoon.\nAt around 1:45 p.m. local time, Israelis in the center of the country got an alert to head to shelters due to an incoming miss... [729 chars]",
            "url": "https://www.jpost.com/middle-east/iran-news/article-888809",
            "image": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/707737",
            "publishedAt": "2026-03-04T13:06:34Z",
            "lang": "en",
            "source": {
                "id": "78834c45a26f98bca295cc641123cf7f",
                "name": "The Jerusalem Post",
                "url": "https://www.jpost.com"
            }
        }
    ]
}

Categories