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": 515966,
    "articles": [
        {
            "id": "13b13e2a4607b1d3ef01d4e64df6087c",
            "title": "Hantavirus outbreak kills 3 on cruise ship in the Atlantic Ocean, WHO says",
            "description": "Hantaviruses are usually spread by exposure to urine, saliva or feces from infected rodents, such as rats or mice. Hantavirus infections are rare but can cause deadly respiratory infections.",
            "content": "Three people have died in an outbreak of a dangerous respiratory virus on a cruise ship in the Atlantic Ocean, according to the World Health Organization.\nAt least six people are believed to have been infected with a hantavirus, including one whose i... [1460 chars]",
            "url": "https://www.npr.org/2026/05/03/nx-s1-5809495/hantavirus-outbreak-cruise-ship-atlantic-ocean",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/3600x2025+0+373/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F52%2F1b%2F6b1c204542c3a0170db363fd6dd8%2Fgettyimages-2273813943.jpg",
            "publishedAt": "2026-05-03T23:30:14Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "c305848f060d8e229fc16573102b3dd9",
            "title": "Kimi Antonelli produces gutsy drive to hold off Norris and win F1 Miami GP",
            "description": "The Mercedes driver claimed his third consecutive win this season by edging a battle with Lando Norris to extend his championship lead to 20 points over George Russell",
            "content": "The margins were fine but ultimately it was a champion’s composure that won the day for Kimi Antonelli at the Miami Grand Prix. The teenager cannot legally buy a drink in the US yet but by the end of what was a gripping run to the flag the Italian ha... [4882 chars]",
            "url": "https://www.theguardian.com/sport/2026/may/03/kimi-antonelli-produces-gutsy-drive-to-hold-off-norris-and-win-f1-miami-gp",
            "image": "https://i.guim.co.uk/img/media/2371f7b0cebf1fad3a3d7eb3d3ed85fa1b769974/675_629_4089_3271/master/4089.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=b2b3654ed3d38364cde714b884da9877",
            "publishedAt": "2026-05-03T23:12:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "ff1ebd24990e4e127d63d68fd617a21a",
            "title": "‘Devil Wears Prada’ Sequel Leads Box Office With $77 Million",
            "description": "It was the biggest opening weekend for a traditional comedy in 11 years. One analyst called the debut “sensational.”",
            "content": "Older actresses aren’t bankable? The blockbuster era for traditional comedies is over, with streaming having siphoned away the audience?\nMeryl Streep, 76, stepped back into Miranda Priestly’s sky-high heels over the weekend and demolished those Holly... [1357 chars]",
            "url": "https://www.nytimes.com/2026/05/03/business/devil-wears-prada-2-box-office.html",
            "image": "https://static01.nyt.com/images/2026/04/30/espanol/30cul-devilwearsprada-review-kzhp-ES-copy1/30cul-devilwearsprada-review-kzhp-facebookJumbo.jpg",
            "publishedAt": "2026-05-03T23:01:29Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories