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": 391582,
    "articles": [
        {
            "id": "4626b1105e836790efba8e1e2edf631b",
            "title": "'Today' show host Savannah Guthrie's mother reported missing in Arizona: Sheriff",
            "description": "An 84-year-old woman who was reported missing in Arizona has been identified by officials as the mother of \"Today\" show host Savannah Guthrie.",
            "content": "An 84-year-old woman who was reported missing in Arizona has been identified by officials as the mother of \"Today\" show host Savannah Guthrie.\nThe Pima County Sheriff’s Department announced during a news conference on Sunday that Nancy Guthrie was la... [949 chars]",
            "url": "https://abcnews.go.com/US/today-show-host-savannah-guthries-mother-reported-missing/story?id=129770864",
            "image": "https://i.abcnewsfe.com/a/438ec9a4-148a-462e-a37b-48900ca68062/nancy_1770005999433_hpMain_16x9.jpeg?w=1600",
            "publishedAt": "2026-02-02T11:48:32Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "ABC News",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "id": "70e9029bf2249c1dd498274dcc1d97fc",
            "title": "Trump Assails Grammys and Threatens to Sue Trevor Noah Over Epstein Joke",
            "description": "President Trump declared the awards ceremony “virtually unwatchable” and accused Mr. Noah of defamation over a joke he made that appeared to tie the president to Jeffrey Epstein.",
            "content": "President Trump on Monday sharply criticized this year’s Grammys telecast and threatened to sue its host, the comedian Trevor Noah, over a joke that appeared to tie Mr. Trump to the convicted sex offender Jeffrey Epstein.\n“The Grammy Awards are the W... [1881 chars]",
            "url": "https://www.nytimes.com/2026/02/02/arts/television/trump-grammys-trevor-noah.html",
            "image": "https://static01.nyt.com/images/2026/02/02/multimedia/02cul-grammys-trump-mzwc/02cul-grammys-trump-mzwc-facebookJumbo.jpg",
            "publishedAt": "2026-02-02T09:54:56Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "8343191fc2a975ccede78c4a1440eb1b",
            "title": "What to Know About the Rafah Border Crossing in Gaza",
            "description": "The only crossing that connects Gaza with Egypt is reopening after nearly a year of closures. This will allow residents to leave for medical care or return to homes and families in the territory.",
            "content": "The only border crossing that connects Gaza with Egypt prepared to open on Sunday for the first time in almost a year, a step that will throw a lifeline to Palestinians who want to leave for medical care or return to homes and families after two year... [1550 chars]",
            "url": "https://www.nytimes.com/2026/02/01/world/middleeast/rafah-crossing-gaza-egypt-israel.html",
            "image": "https://static01.nyt.com/images/2026/01/27/multimedia/00int-rafahcrossing-wtk01-photo-cbpk/00int-rafahcrossing-wtk01-photo-cbpk-facebookJumbo.jpg",
            "publishedAt": "2026-02-02T09:21:55Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories