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": 481656,
    "articles": [
        {
            "id": "573a3484727f682b9c1caa156cc89957",
            "title": "BTS thrills K-pop fans in Seoul with first concert in nearly four years",
            "description": "The South Korean megastars thrilled tens of thousands of fans with their first concert in nearly four years following a break for military service and solo careers.",
            "content": "The South Korean megastars thrilled tens of thousands of fans with their first concert in nearly four years following a break for military service and solo careers.\nMarch 21, 2026 at 11:07 a.m. EDTToday at 11:07 a.m. EDT\nSEOUL — BTS is back, and the ... [419 chars]",
            "url": "https://www.washingtonpost.com/world/2026/03/21/bts-arirang-kpop-seoul/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/3G4LDTD3JSAM6FJETFJXPNSCVM.jpg&w=1440",
            "publishedAt": "2026-03-21T21:08:39Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "e9c9f6057436dc44f9d1caa8d136895d",
            "title": "Robert Mueller, former special counsel who led Trump-Russia probe, dies at 81",
            "description": "Robert Mueller III, the long-serving FBI director who later served as the special counsel overseeing the investigation into Russian interference in the 2016 election, has died.",
            "content": "Robert Mueller III, the long-serving FBI director who later served as the special counsel overseeing the investigation into Russian interference in the 2016 election, has died. He was 81.\nIn a statement, his family said: “With deep sadness, we are sh... [4767 chars]",
            "url": "https://www.nbcnews.com/politics/politics-news/robert-mueller-former-special-counsel-dies-rcna264561",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-03/260321-Robert-Mueller-ch-1316-663f6d.jpg",
            "publishedAt": "2026-03-21T20:17:01Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "6e57c184671963cf3f1ae7754b63d13c",
            "title": "Main Card Results | UFC London",
            "description": "Live Results, Highlights, Post-Fight Interviews With The Main Card Winners And More From UFC Fight Night: Evloev vs Murphy, Live From The O2 In London, England On March 21, 2026",
            "content": "Live Results, Highlights, Post-Fight Interviews With The Main Card Winners And More From UFC Fight Night: Evloev vs Murphy, Live From The O2 In London, England On March 21, 2026\nThe Octagon returns to The O2 in London, England for a high-stakes showd... [2244 chars]",
            "url": "https://www.ufc.com/news/ufc-london-results-evloev-vs-murphy-main-card-highlights-winners-interviews",
            "image": "https://ufc.com/images/styles/card/s3/2026-02/032126-ufc-fight-night-evloev-vs-murphy-EVENT-ART.jpg?itok=j2T_QIC7",
            "publishedAt": "2026-03-21T20:03:19Z",
            "lang": "en",
            "source": {
                "id": "bd5f280a54e7a5c1f8e0b1de09005bc3",
                "name": "UFC.com",
                "url": "https://www.ufc.com"
            }
        }
    ]
}

Categories