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": 371256,
    "articles": [
        {
            "id": "e085ec9f858039aafbfa72d5327cef1d",
            "title": "White Sox Trade Luis Robert Jr. To Mets",
            "description": "Luis Robert haș finally been traded after years of rumors. Find the details on the move at MLB Trade Rumors.",
            "content": "10:40pm: Chicago is not sending any cash in the deal, reports Jon Heyman of The New York Post. The Mets are picking up Robert’s $20MM salary and at least a $2MM buyout on next year’s $20MM club option.\n10:19pm: The Mets and White Sox are in agreement... [5717 chars]",
            "url": "https://www.mlbtraderumors.com/2026/01/mets-to-acquire-luis-robert.html",
            "image": "https://cdn.mlbtraderumors.com/files/2026/01/USATSI_26845958-1024x683.jpg",
            "publishedAt": "2026-01-21T04:19:07Z",
            "lang": "en",
            "source": {
                "id": "95e9972ed9d1a75fccc1269425e6b80e",
                "name": "MLB Trade Rumors",
                "url": "https://www.mlbtraderumors.com"
            }
        },
        {
            "id": "9bc935abe96d15c8ec776980e89d09e3",
            "title": "Man gets life in prison in assassination of ex-Japanese leader",
            "description": "A Japanese court sentenced a man who admitted assassinating former Japanese Prime Minister Shinzo Abe to life imprisonment, according to NHK public television.",
            "content": "TOKYO (AP) — A Japanese court sentenced a man who admitted assassinating former Japanese Prime Minister Shinzo Abe to life imprisonment on Wednesday, according to NHK public television. The case has revealed decades of cozy ties between Japan’s gover... [2940 chars]",
            "url": "https://apnews.com/article/japan-abe-assassination-trial-unification-church-925d6cc24e58c50d530736af15fe8c35",
            "image": "https://dims.apnews.com/dims4/default/0e9cdfa/2147483647/strip/true/crop/4576x2574+0+238/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F32%2F95%2Fc304c9fbee214accd8e3e2b244bf%2F1c47f13729ed40cfac35a08fc9d6602c",
            "publishedAt": "2026-01-21T04:19:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "d9b48df917dbbcbf2b6887732617682e",
            "title": "Air Force One Turns Back After Electrical Issue",
            "description": "The plane carrying President Trump was heading for Switzerland when it turned back for Joint Base Andrews. A White House official said there had been a minor electrical issue.",
            "content": "Air Force One returned to Joint Base Andrews late Tuesday with President Trump on board after experiencing a “minor electrical issue,” a White House official said.\nThe White House press secretary, Karoline Leavitt, said that Mr. Trump would board a d... [955 chars]",
            "url": "https://www.nytimes.com/2026/01/20/us/politics/air-force-one-trump-turn-around.html",
            "image": "https://static01.nyt.com/images/2026/02/20/multimedia/20trump-news-air-force-one-mfch/20trump-news-air-force-one-mfch-facebookJumbo.jpg",
            "publishedAt": "2026-01-21T03:58:49Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories