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": 243294,
    "articles": [
        {
            "id": "5d1c18d7f619e8561873c18c1fd06fcb",
            "title": "Trump outlines 'worst case' scenario",
            "description": "President Trump and top White House officials said the U.S.-Israeli war against Iran could last weeks and that the \"hardest hits are yet to come.\"",
            "content": "6:19 pm ET\nPentagon identifies 4 US soldiers killed in war with Iran\nMichael Loria\nU.S. military officials have released the names of four American soldiers killed so far in the war with Iran.\nAccording to the Pentagon, they are Capt. Cody A. Khork, ... [23318 chars]",
            "url": "https://www.usatoday.com/live-story/news/politics/2026/03/03/iran-us-israel-war-live-updates/88956478007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/03/03/USAT/88956692007-2264412227.jpg?crop=6719,3780,x0,y224&width=3200&height=1801&format=pjpg&auto=webp",
            "publishedAt": "2026-03-03T23:34:00Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        },
        {
            "id": "74b00f560a94fb300a3b2c4d910c58bd",
            "title": "Gulf Arab States Under Pressure As Iranian Attacks Grind On (Updated)",
            "description": "Energy infrastructure and ports around the Gulf are increasingly on the receiving end of Iranian drones and missiles.",
            "content": "The TWZ Newsletter\nWeekly insights and analysis on the latest developments in military technology, strategy, and foreign policy.\nEmail address Thank you!\nIran appears to be increasingly focusing its retaliatory attacks against energy production infra... [17718 chars]",
            "url": "https://www.twz.com/news-features/gulf-arab-states-under-pressure-as-iranian-attacks-grind-on",
            "image": "https://www.twz.com/wp-content/uploads/2026/03/arab-states-pressure-iran-attacks-middle-east-war.jpg?w=1200",
            "publishedAt": "2026-03-03T22:22:05Z",
            "lang": "en",
            "source": {
                "id": "363cabb787924c2b094917680adf0109",
                "name": "The War Zone",
                "url": "https://www.twz.com"
            }
        },
        {
            "id": "7f395293535ce0f6e132b665c7c226e3",
            "title": "U.S. and Israel Striking Iran Security Agencies That Helped Crush Protests",
            "description": "Their attacks have targeted police stations and intelligence bases in what may be part of a plan to encourage Iranians to rise up against the government, experts say.",
            "content": "The United States and Israel have been striking Iran’s police stations, detention centers and intelligence offices in addition to typical military targets, in an apparent effort to weaken the country’s labyrinthine and entrenched security agencies.\nT... [1494 chars]",
            "url": "https://www.nytimes.com/2026/03/03/world/middleeast/us-israel-strikes-iran-state-security-police.html",
            "image": "https://static01.nyt.com/images/2026/03/03/multimedia/03iran-live-security-targets-gmwz/03iran-live-security-targets-gmwz-facebookJumbo.jpg",
            "publishedAt": "2026-03-03T19:59:15Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories