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": 515870,
    "articles": [
        {
            "id": "d3dfa362626094ce9ee0b4bc9013ee91",
            "title": "Hantavirus possibly transmitted human to human on stranded cruise ship, WHO says",
            "description": "Passengers aboard the ship are in good spirits but may have to quarantine for \"eight weeks,\" a World Health Organization official told CBS News.",
            "content": "The World Health Organization said Tuesday it believes there was rare human-to-human transmission of the hantavirus on a cruise ship at the center of the outbreak, with three people now dead after coming down with the illness.\n\"We do believe that the... [6998 chars]",
            "url": "https://www.cbsnews.com/news/spain-agrees-welcome-hantavirus-cruise-ship-who/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/05/05/5c8d111d-9b19-4fa2-8a86-8dc4b6b2cdb3/thumbnail/1200x630/478cad5f5c45ccd8a16c47e899312095/gettyimages-2273953428.jpg",
            "publishedAt": "2026-05-05T23:17:22Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "88b43bf9b0967bc1ef996b96da28c90c",
            "title": "Griffin calls NYC Mayor Mamdani's tax the rich video 'creepy and weird'",
            "description": "Citadel CEO Ken Griffin called NYC Mayor Zohran Mamdani's \"tax the rich\" video \"creepy and weird,\" saying it reaffirmed his decision to expand business in Miami.",
            "content": "Citadel founder and CEO Ken Griffin described New York City Mayor Zohran Mamdani’s \"tax the rich\" video targeting him as a \"creepy and weird\" political advertisement.\nSpeaking at the Milken Conference in Los Angeles on Tuesday, Griffin said Mamdani’s... [2981 chars]",
            "url": "https://www.foxbusiness.com/media/billionaire-says-mamdanis-tax-rich-video-outside-nyc-apartment-creepy-frightening",
            "image": "https://a57.foxnews.com/static.foxbusiness.com/foxbusiness.com/content/uploads/2026/05/0/0/mamdani-ken-griffin.png?ve=1&tl=1",
            "publishedAt": "2026-05-05T22:30:00Z",
            "lang": "en",
            "source": {
                "id": "2129172d996b80818e14ef74fc4d88e6",
                "name": "Fox Business",
                "url": "https://www.foxbusiness.com"
            }
        },
        {
            "id": "b7b7831fb2d7c6179e5dc7bbe01239d7",
            "title": "Man charged with attempted Trump assassination indicted for assaulting Secret Service officer",
            "description": "Cole Tomas Allen is now facing charges from a grand jury indictment, which supersedes his previous charges.",
            "content": "The California man who allegedly tried to assassinate President Donald Trump at a Washington gala has been indicted on a fourth charge of assaulting a US officer or employee with a deadly weapon.\nThe new charge comes in the wake of questions over whe... [1714 chars]",
            "url": "https://www.bbc.com/news/articles/clyp5rr0lm6o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/8fca/live/8e77ac70-48c9-11f1-afb4-1b52e3f0d656.jpg",
            "publishedAt": "2026-05-05T22:01:22Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories