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": 238046,
    "articles": [
        {
            "id": "d5e4e7822b636121bfbb7a8ee5df5a58",
            "title": "Iranian Kamikaze Drone Boat Makes First Successful Strike Of War",
            "description": "Iran, a pioneer in lower-end uncrewed surface vessel technology, used at least one to attack the oil tanker MKD VYOM in the Gulf of Oman.",
            "content": "The TWZ Newsletter\nWeekly insights and analysis on the latest developments in military technology, strategy, and foreign policy.\nEmail address Thank you!\nA Marshall Islands-flagged oil tanker became the first ship to be struck by an Iranian uncrewed ... [6280 chars]",
            "url": "https://www.twz.com/news-features/iranian-kamikaze-drone-boat-makes-first-successful-strike-of-war",
            "image": "https://www.twz.com/wp-content/uploads/2026/03/Drone-boat-attack.jpg?w=1200",
            "publishedAt": "2026-03-02T21:31:15Z",
            "lang": "en",
            "source": {
                "id": "363cabb787924c2b094917680adf0109",
                "name": "The War Zone",
                "url": "https://www.twz.com"
            }
        },
        {
            "id": "eaea8305f1d73c1965deb6735933e17c",
            "title": "Pakistan Strikes Bagram Air Base, Satellite Images Show",
            "description": "Satellite imagery showed flattened warehouses at the base that served as the nerve center of America’s 20-year war in Afghanistan, a prized asset for the Taliban.",
            "content": "The Pakistani military hit Bagram Air Base on Sunday, according to satellite images obtained by The New York Times, escalating its war against Afghanistan by targeting a prized asset of the Taliban administration.\nA Pakistani military official, speak... [946 chars]",
            "url": "https://www.nytimes.com/2026/03/02/world/asia/pakistan-bagram-airbase-afghanistan-war.html",
            "image": "https://static01.nyt.com/images/2026/03/03/video/03int-bagram1/03int-bagram1-facebookJumbo.png",
            "publishedAt": "2026-03-02T20:46:16Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "ac3186b5330c3769d2b06711630fa755",
            "title": "Live Updates: U.S.-Israel conflict with Iran widens",
            "description": "Iran and Iranian-backed militias fired missiles at Israel and Arab states, apparently hitting the U.S. Embassy compound in Kuwait, while Israel and the United States pounded targets in Iran as the war expanded Monday with statements of defiance and increasing casualties.",
            "content": "Iranian cleric Alireza Arafi, delivering his first public remarks since he was made a member of Iran's temporary leadership council, said he hoped that a new supreme leader would be \"quickly\" appointed to replace Ali Khamenei.\nHere is the latest.\n3:0... [49199 chars]",
            "url": "https://www.pbs.org/newshour/world/live-updates-u-s-israel-conflict-with-iran-widens",
            "image": "https://d3i6fh83elv35t.cloudfront.net/static/2026/03/2026-03-02T141805Z_586158097_RC2DWJAQFFMK_RTRMADP_3_IRAN-CRISIS-ISRAEL-LEBANON-1024x683.jpg",
            "publishedAt": "2026-03-02T19:51:02Z",
            "lang": "en",
            "source": {
                "id": "7194247a4f44906ac877ec001837157c",
                "name": "PBS",
                "url": "https://www.pbs.org"
            }
        }
    ]
}

Categories