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": 375936,
    "articles": [
        {
            "id": "464ffbd8a7c25e5da7748030007cc701",
            "title": "What people around MLB are saying about the MacKenzie Gore deal, plus more offseason notes",
            "description": "We also detail Max Scherzer's free-agent timeline, the other Freddy Peralta suitors and the impact of local TV uncertainty.",
            "content": "Prospect-based trades are impossible to evaluate the day they are made, and often for years afterward. But within the industry, certain types of deals are immediately recognizable.\nThe Washington Nationals’ trade Thursday of left-hander MacKenzie Gor... [9030 chars]",
            "url": "https://www.nytimes.com/athletic/6993006/2026/01/22/mackenzie-gore-rangers-nationals-max-scherzer/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/01/22211011/GettyImages-2216760421-scaled.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-01-23T02:30:07Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "5be8e9c20bde70ca4de401e812f06a73",
            "title": "Federal jury rejects Bovino murder plot after attorney calls on it to 'stop the overreaching government'",
            "description": "It took jurors roughly three hours to acquit Juan Espinoza Martinez of a murder-for-hire aimed at U.S. Border Patrol Cmdr. Gregory Bovino, the face of Operation Midway Blitz.",
            "content": "Federal authorities slapped all kinds of sinister labels on Chicago’s Juan Espinoza Martinez when they arrested him last fall, and they did it for all the world to hear.\nThey called him a “high-ranking member of the Latin Kings.” They called him “dep... [6054 chars]",
            "url": "https://chicago.suntimes.com/immigration/2026/01/22/federal-jury-rejects-bovino-murder-plot-after-called-upon-stand-up-overreaching-government",
            "image": "https://cst.brightspotcdn.com/dims4/default/04242b0/2147483647/strip/true/crop/2528x1443+0+121/resize/1461x834!/quality/90/?url=https%3A%2F%2Fchorus-production-cst-web.s3.us-east-1.amazonaws.com%2Fbrightspot%2F98%2F24%2F8c5a3b0a4172aeb6236f2a664097%2Fbovino-102925-14.jpg",
            "publishedAt": "2026-01-23T02:30:00Z",
            "lang": "en",
            "source": {
                "id": "7cf6361ad317eef16bc9ae022f20bbf0",
                "name": "chicago.suntimes.com",
                "url": "https://chicago.suntimes.com"
            }
        },
        {
            "id": "63d82b9040dd229f031f53bcc7ab87a1",
            "title": "Mark Carney Says Firmly That ‘Canada Doesn’t Live Because of the United States’",
            "description": "The Canadian prime minister spoke after returning from the World Economic Forum where he urged middle powers to team up in resisting President Trump.",
            "content": "When Mark Carney became Canada’s prime minister last year, he was known mostly as a technocratic central banker who had gone on to success in the world of global finance.\nBut when Mr. Carney returned this week from the World Economic Forum in Davos, ... [1726 chars]",
            "url": "https://www.nytimes.com/2026/01/22/world/canada/carney-trump-canada-speech.html",
            "image": "https://static01.nyt.com/images/2026/01/22/multimedia/22canada-carney-bzlg/22canada-carney-bzlg-facebookJumbo.jpg",
            "publishedAt": "2026-01-23T02:23:24Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories