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": 250160,
    "articles": [
        {
            "id": "87de00a0fa602830d9878a793f3bb41c",
            "title": "15 injured, one seriously, as Iranian cluster munitions impact in central Israel",
            "description": "36 people, 19 of them children, still hospitalized from direct hits in southern cities of Dimona and Arad; at impact site, Netanyahu says, 'If you're in a shelter, you're protected'",
            "content": "Fifteen people were injured on Sunday, one of them seriously, when an Iranian ballistic missile dropped cluster munitions in central Israel, paramedics said, in the Islamic Republic’s fourth ballistic missile attack since midnight.\nThe missile spread... [7021 chars]",
            "url": "https://www.timesofisrael.com/15-injured-one-seriously-as-iranian-cluster-munitions-impact-in-central-israel/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/03/F260322TG09.jpg",
            "publishedAt": "2026-03-22T16:08:42Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        },
        {
            "id": "9b4467b8b530bbc9d202567ae5aceea0",
            "title": "Israel Orders Military to Intensify Demolitions in Southern Lebanon",
            "description": "Defense Minister Israel Katz instructed troops to destroy more bridges and buildings in southern Lebanon, stoking worries that Israel could expand a military-controlled buffer zone there.",
            "content": "The Israeli defense minister said Sunday that he had ordered the military to step up its destruction of bridges and houses in southern Lebanon, adding to fears over Israel’s plans in its offensive against Hezbollah that has already killed more than 1... [2773 chars]",
            "url": "https://www.nytimes.com/2026/03/22/world/middleeast/israel-lebanon-fighting-hezbollah.html",
            "image": "https://static01.nyt.com/images/2026/03/22/multimedia/22israel-iran-Lebanon-escalation-lhtm/22israel-iran-Lebanon-escalation-lhtm-facebookJumbo.jpg",
            "publishedAt": "2026-03-22T14:29:17Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "936d475849dd88617a4b999e09bbe6d2",
            "title": "Benjamin Netanyahu warns Europe against Iran, calls on leaders to join war",
            "description": "\"We're responding with great force, but not after civilians,\" Netanyahu said when asked by press what Israel's response would be to the Iranian attacks.",
            "content": "Prime Minister Benjamin Netanyahu called on world leaders to join the US-Israeli operation against Iran, as he and numerous other Israeli officials visited the impact site of an Iranian missile attack in the southern city of Arad on Sunday.\n\"If you w... [3501 chars]",
            "url": "https://www.jpost.com/israel-news/article-890798",
            "image": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/712693",
            "publishedAt": "2026-03-22T12:58:10Z",
            "lang": "en",
            "source": {
                "id": "78834c45a26f98bca295cc641123cf7f",
                "name": "The Jerusalem Post",
                "url": "https://www.jpost.com"
            }
        }
    ]
}

Categories