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": 552762,
    "articles": [
        {
            "id": "0c8ef8b732449cab340844848698e49d",
            "title": "2 workers reportedly shot inside Wilmington Hospital in Delaware; facility on lockdown",
            "description": "Two people were shot inside Wilmington Hospital in Wilmington, Delaware, on Tuesday afternoon.",
            "content": "WILMINGTON, Del. (WPVI) -- Two people were shot inside Wilmington Hospital in Wilmington, Delaware, on Tuesday afternoon.\nPolice officials say officers were called to the facility in the 500 block of W. 14th Street around 3:30 p.m.\nArriving officers ... [1403 chars]",
            "url": "https://6abc.com/post/possible-shooting-reported-wilmington-hospital-delaware/19310822/",
            "image": "https://cdn.abcotvs.com/dip/images/14517665_031224-wpvi-live-coverage-2024-generic-img.png?w=1600",
            "publishedAt": "2026-06-16T23:25:19Z",
            "lang": "en",
            "source": {
                "id": "52f2d1de7744cf1460c7c099217b8863",
                "name": "6abc Philadelphia",
                "url": "https://6abc.com"
            }
        },
        {
            "id": "f08dfc479f33231bc75a514f0703e078",
            "title": "Hantavirus cruise passenger says she’s being forced to quarantine in Nebraska",
            "description": "Health Secretary Robert F. Kennedy Jr. said her isolation was needed to protect public health, though the CDC has recommended home quarantine under certain conditions.",
            "content": "A passenger from the hantavirus-stricken cruise ship has said she is being held in quarantine away from her home against her will and despite the recommendations of a medical review by the CDC.\nHealth Secretary Robert F. Kennedy Jr., who has long dec... [313 chars]",
            "url": "https://www.washingtonpost.com/health/2026/06/16/hantavirus-cruise-passenger-says-shes-being-forced-quarantine-nebraska/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/YDR5XUJTVXEXELD745J7FWY3N4_size-normalized.jpg&w=1440",
            "publishedAt": "2026-06-16T23:19:21Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "ab24b597ce868b92b177f4148f32f387",
            "title": "Georgia and Alabama GOP runoffs and more primaries to watch today",
            "description": "Voters are casting ballots in four states and the District of Columbia on Tuesday, including the runoff race in Georgia to take on Democratic Sen. Jon Ossoff.",
            "content": "Washington — Polls have closed Tuesday in Georgia, which is holding a high-profile runoff race to take on Democratic Sen. Jon Ossoff and a GOP runoff in the contest for governor.\nGeorgia is one of four states and the District of Columbia where voters... [8619 chars]",
            "url": "https://www.cbsnews.com/news/primaries-georgia-senate-governor-republican-runoff-alabama-oklahoma-washington-dc/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/05/13/0d74891b-e92d-41f3-8d6a-1d8ec189cc4f/thumbnail/1200x630/60c739f7859e3ff79564007b8d5ae967/ap26117815749452.jpg",
            "publishedAt": "2026-06-16T23:05:57Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories