United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 540996,
    "articles": [
        {
            "id": "4b363f0790bd27466fabc07d4b530025",
            "title": "‘60 Minutes’ Correspondent Calls Bari Weiss ‘Disingenuous’",
            "description": "Pelley’s ouster is the latest in a series of controversies at CBS News since the network’s owners hired Bari Weiss to take over as editor-in-chief last year.",
            "content": "Topline\nFormer “60 Minutes” correspondent Scott Pelley accused CBS News’ editor-in-chief Bari Weiss of “lying” to staff during a conference call, claiming Weiss and the network’s president and executive editor Tom Cibrowski were “openly hostile from ... [4347 chars]",
            "url": "https://www.forbes.com/sites/siladityaray/2026/06/03/scott-pelley-calls-bari-weiss-disingenuous-after-she-defended-firing-60-minutes-journalist/",
            "image": "https://imageio.forbes.com/specials-images/imageserve/6a1f9fb90aac4fcf05f8adf0/0x0.jpg?format=jpg&height=900&width=1600&fit=bounds",
            "publishedAt": "2026-06-03T17:29:00Z",
            "lang": "en",
            "source": {
                "id": "c4e32b557a3dd75225975f11fb68a3a9",
                "name": "Forbes",
                "url": "https://www.forbes.com"
            }
        },
        {
            "id": "31f0a99734bf6b040cf318a9e1750f86",
            "title": "Iran War Live Updates: Kuwait Says One Killed and Dozens Injured in Iranian Attack on Airport",
            "description": "Video footage verified by The New York Times showed fire inside Kuwait’s international airport. The attack was part of one of the biggest assaults on a Gulf nation since the U.S.-Iran cease-fire was announced in April.",
            "content": "Current time in\nTehran7:54 p.m. June 3\nLive\nIran War Live Updates: Drone Barrage at Kuwait Airport Kills One and Injures Dozens\nVideo footage verified by The New York Times showed fire inside Kuwait’s international airport. The attack was part of one... [11411 chars]",
            "url": "https://www.nytimes.com/live/2026/06/03/world/iran-war-trump-israel-lebanon",
            "image": "https://static01.nyt.com/images/2026/06/03/multimedia/03mideast-gulf-attacks-wzqp/03mideast-gulf-attacks-wzqp-facebookJumbo.jpg",
            "publishedAt": "2026-06-03T16:15:34Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "b3f3c4dbac385ccb672ecb772a534980",
            "title": "FBI agents fatally shoot alleged hostage-taker in California",
            "description": "The shooting ends a 12-hour standoff in the city of Bakersfield between suspect and law enforcement.",
            "content": "Agents with the Federal Bureau of Investigations (FBI) in the United States have fatally shot a man allegedly holding hostages inside a building in California.\nThe shooting ended a 12-hour standoff at an office in Bakersfield that houses a bank branc... [1319 chars]",
            "url": "https://www.aljazeera.com/news/2026/6/3/fbi-agents-fatally-shoot-alleged-hostage-taker-in-california",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/06/ap_6a204737d82bd-1780500279.jpg?resize=1920%2C1440",
            "publishedAt": "2026-06-03T15:34:49Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        }
    ]
}

Categories