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": 521884,
    "articles": [
        {
            "id": "42d780f5f5072564f676babbf1b30dbb",
            "title": "NBA play-offs: LeBron James helps Los Angeles Lakers to overtime win at Houston and 3-0 series lead",
            "description": "LeBron James makes a three-pointer to force overtime before the Los Angeles Lakers move to the brink of series victory in the NBA play-offs.",
            "content": "LeBron James made a three-pointer to force overtime before the Los Angeles Lakers moved to the brink of a series victory in the NBA play-offs.\nThe NBA's four-time Most Valuable Player levelled the score with 13 seconds left against the Houston Rocket... [1699 chars]",
            "url": "https://www.bbc.com/sport/basketball/articles/cn8d012gqdeo",
            "image": "https://ichef.bbci.co.uk/ace/branded_sport/1200/cpsprodpb/c718/live/1f6f97a0-407e-11f1-b92d-1390db4c1e47.jpg",
            "publishedAt": "2026-04-25T08:25:00Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "ca7acf7953b06c0181c6cf0d3f58dfd8",
            "title": "Ukrainian Drones Strike Urals for First Time in Record 1,800-km Raid",
            "description": "Explosions were reported at military and industrial sites in Yekaterinburg and Chelyabinsk as Kyiv’s long-range campaign reaches deep into Russian territory.",
            "content": "Ukrainian long-range drones reached the Ural Mountains for the first time during the night of Friday-Saturday, marking a record-breaking mission that bypassed Russian air defenses for over 10 hours.\nSerhii Sternenko, an adviser to the Ukrainian Minis... [2333 chars]",
            "url": "https://www.kyivpost.com/post/74725",
            "image": "https://static.kyivpost.com/storage/2026/04/25/4087013aa5edede44e0df930861a2710.png?w=1200&q=90&f=jpg",
            "publishedAt": "2026-04-25T07:15:38Z",
            "lang": "en",
            "source": {
                "id": "02c887af92e2e2e697e74bf65abd5a9b",
                "name": "Kyiv Post",
                "url": "https://www.kyivpost.com"
            }
        },
        {
            "id": "fe109c2cd129fd2378b32396be94121b",
            "title": "Iran's foreign minister awaits U.S. delegation to Pakistan for peace talks",
            "description": "Iran's Abbas Araghchi arrived in Islamabad on Friday, as the White House confirmed Steve Witkoff and Jared Kushner will travel there Saturday to try to \"move the ball forward towards a deal.\"",
            "content": "The White House has confirmed that U.S. special envoy Steve Witkoff and President Trump's son-in-law Jared Kushner are planning to travel to Pakistan Saturday for a new round of talks with Iran.\nIran's foreign minister Abbas Araghchi on Friday arrive... [8425 chars]",
            "url": "https://www.npr.org/2026/04/25/nx-s1-5799372/iran-middle-east-updates",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/1024x576+0+46/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F59%2F81%2F2aefffa943098ef4ebd300415fdb%2Fgettyimages-2272187995.jpg",
            "publishedAt": "2026-04-25T06:35:21Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories