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": 515496,
    "articles": [
        {
            "id": "b9767025cfc16de6ec5124dd05f06d15",
            "title": "UK Prime Minister Keir Starmer Says He Will Not Resign: Live Updates",
            "description": "Prime Minister Keir Starmer vowed to continue in office as he met with cabinet members. Dozens of Labour Party lawmakers had urged him to step down after heavy losses in local elections.",
            "content": "Mr. Starmer was facing a fast-moving rebellion within his party after it suffered major losses in last week’s local elections in England, and in parliamentary elections in Scotland and Wales. Dozens of Labour Party lawmakers have publicly urged him t... [4056 chars]",
            "url": "https://www.nytimes.com/live/2026/05/12/world/uk-starmer",
            "image": "https://static01.nyt.com/images/2026/05/12/multimedia/12uk-starmer-promo/12uk-starmer-headerlaunch-bqpk-facebookJumbo.jpg",
            "publishedAt": "2026-05-12T09:36:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "6bc8240f5d87baffc9375034ed58fecf",
            "title": "Nancy Guthrie has been missing for 100 days. Her case upended Hollywood’s portrayal of solving crime",
            "description": "For many experts steeped in the intricacies of missing persons cases, the Guthrie investigation has raised questions about whether the general public has been conditioned to hold outsized and unrealistic expectations of law enforcement’s capabilities.",
            "content": "It’s been 100 days since Nancy Guthrie was tragically abducted and neither the police, pundits nor online amateur sleuths appear to have a clue where she is.\nDespite hundreds of sheriff’s deputies, FBI agents and volunteers searching for the 84-year-... [8071 chars]",
            "url": "https://www.cnn.com/2026/05/12/us/nancy-guthrie-missing-100-days",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2261863096.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-05-12T09:00:50Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "e792e16678610704f8fe553c2f056f47",
            "title": "Stephen Colbert and late night hosts strike again as his show nears finale",
            "description": "Stephen Colbert invited his \"best television friends,\" fellow late night hosts John Oliver, Seth Meyers and the two Jimmies— Kimmel and Fallon— to join him, as his final show on CBS is set for May 21.",
            "content": "Stephen Colbert invited his \"best television friends,\" fellow late night hosts John Oliver, Seth Meyers and the two Jimmies— Kimmel and Fallon— to join him as his show on CBS/ Paramount Plus winds down. One of Colbert's final episodes was a reunion o... [2578 chars]",
            "url": "https://www.npr.org/2026/05/12/nx-s1-5819155/colbert-late-night-hosts-strike-again",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/3000x1688+0+156/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F9c%2F69%2F79fce82a400490df68ce8b56e05a%2F3211230-0693.jpg",
            "publishedAt": "2026-05-12T08:27:15Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories