Flag of United States

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": 472484,
    "articles": [
        {
            "id": "7e32cde7aaa18d9b490a2711ca31dc9b",
            "title": "Harry Plays Quidditch at Hogwarts",
            "description": "HBO released a photo from its upcoming 'Harry Potter' series showing Harry walking towards the Hogwarts quidditch pitch.",
            "content": "Welcome to Hogwarts! A first look at the fictional school of witchcraft and wizardry from HBO’s upcoming “Harry Potter” series has finally been unveiled.\nThe photo, posted to the show’s official Instagram page, shows Harry (Dominic McLaughlin) from b... [852 chars]",
            "url": "https://variety.com/2026/tv/news/harry-potter-first-look-quidditch-hogwarts-1236463095/",
            "image": "https://variety.com/wp-content/uploads/2026/03/Harry-Potter.jpg?w=1000&h=563&crop=1",
            "publishedAt": "2026-03-24T15:33:00Z",
            "lang": "en",
            "source": {
                "id": "c96d85bc8a846b5845a5420fe892ac16",
                "name": "Variety",
                "url": "https://variety.com"
            }
        },
        {
            "id": "0c658031f8b65c785db141f2a5749ba8",
            "title": "Tom Blyth Slams Critic Who Called Girlfriend's Sheer Dress \"Vulgar\"",
            "description": "People We Meet on Vacation’s Tom Blyth slammed a critic that said his girlfriend Daniela Norman’s sheer dress at the 2026 Vanity Fair Oscars party was “incredibly vulgar.”",
            "content": "Originally appeared on E! Online\nTom Blyth isn’t playing when it comes to his love.\nAfter the dress worn by his girlfriend Daniela Norman to the Vanity Fair’s Oscars Party on March 15 sparked online chatter for its sheerness, the Ballad of Songbirds ... [3026 chars]",
            "url": "https://www.yahoo.com/entertainment/celebrity/articles/tom-blyth-slams-critic-called-145836405.html",
            "image": "https://s.yimg.com/os/en/e__181/3d3594e69f059f8605e86996df59666c",
            "publishedAt": "2026-03-24T14:58:36Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        },
        {
            "id": "2fa03578ae1d8195366646363e456044",
            "title": "Government Cuts Gut the Memory of Argentina’s Dirty War",
            "description": "Fifty years after the military dictatorship, Argentina’s government is defunding human rights groups and promoting a revisionist account of the junta’s crimes.",
            "content": "The sprawling military compound in the heart of Buenos Aires where thousands of people were tortured and disappeared during Argentina’s military dictatorship half a century ago has become a memorial — a monument to the country’s commitment to truth a... [592 chars]",
            "url": "https://www.nytimes.com/2026/03/24/world/americas/government-cuts-argentina-dirty-war.html",
            "image": "https://static01.nyt.com/images/2026/03/24/world/24int-argentina-dictatorship-promo/24int-argentina-dictatorship-promo-facebookJumbo-v3.jpg",
            "publishedAt": "2026-03-24T14:51:30Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories