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": 390848,
    "articles": [
        {
            "id": "f5182fe3ca4f1cd0b3649d099f7328fe",
            "title": "Gisèle Pelicot went public as a rape victim. But her life collapsed.",
            "description": "After Pelicot learned her husband got strangers to assault her while drugged, the French woman testified in open court. A review of her memoir, “A Hymn to Life.”",
            "content": "Gisèle Pelicot bravely went public as a rape victim. But her life collapsed.\nWhen she learned that her husband of 50 years had invited strangers to assault her while drugged, the French woman testified in open court against them. She was hailed as a ... [538 chars]",
            "url": "https://www.washingtonpost.com/books/2026/02/17/gisele-pelicot-memoir-review-rape/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/YRVVI4LHYQHWPCCLIXQMYRRSXY_size-normalized.jpg&w=1440",
            "publishedAt": "2026-02-17T12:40:23Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "74fb0ff026f4b079abdb533592491c05",
            "title": "Jesse Jackson, civil rights leader who ran for president, dies at age 84",
            "description": "The Rev. Jesse Jackson marched alongside Martin Luther King Jr., ran for president in the 1980s and led the Rainbow/PUSH Coalition in Chicago for decades.",
            "content": "The Rev. Jesse Jackson, the famed civil rights leader who marched alongside Martin Luther King Jr. and later ran for president, has died, his family says. He was 84.\nHe died peacefully on Tuesday morning, surrounded by his family, they said in a stat... [6273 chars]",
            "url": "https://www.cbsnews.com/news/jesse-jackson-dies-age-84-civil-rights-leader/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2025/11/17/cc454778-300d-47c3-8935-5d231e0ac507/thumbnail/1200x630/d1dbdb06f4d37facf060b44c77524148/cbsn-fusion-rev-jesse-jackson-is-stable-and-breathing-without-help-from-machines-his-family-says-thumbnail.jpg",
            "publishedAt": "2026-02-17T12:28:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "151eaea4f300647628b0c04814ac6de5",
            "title": "Diet and routine stool tests could help predict IBD flares, large study suggests",
            "description": "A new study suggests that combining routine stool tests and tracking habitual dietary patterns could help to predict IBD flares.",
            "content": "A new study notes that higher levels of a routine stool test marker of gut inflammation is strongly associated with an increased risk of inflammatory bowel disease (IBD) flares, even when people were symptom-free.\nElevated levels of this marker could... [6575 chars]",
            "url": "https://www.aol.com/articles/diet-routine-stool-tests-could-113000363.html",
            "image": "https://s.yimg.com/cv/apiv2/aolfp/images/og-image.png",
            "publishedAt": "2026-02-17T11:41:01Z",
            "lang": "en",
            "source": {
                "id": "4ff2d0fa568705d6b87ce5c9e310a16d",
                "name": "AOL.com",
                "url": "https://www.aol.com"
            }
        }
    ]
}

Categories