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": 540120,
    "articles": [
        {
            "id": "1be228eec6f95596ab42ac0d19a165d1",
            "title": "‘The Mandalorian And Grogu’ Sets A Rotten Tomatoes Audience Score Record",
            "description": "The Mandalorian and Grogu did not review amazingly with critics, but audiences are a lot more on board, according to Rotten Tomatoes scores.",
            "content": "While The Mandalorian and Grogu has one of the lowest Rotten Tomatoes critic scores in Star Wars history, and the second-lowest of the Disney era, that is not true for its audience scores. At least so far.\nIn early viewings, The Mandalorian and Grogu... [2250 chars]",
            "url": "https://www.forbes.com/sites/paultassi/2026/05/22/the-mandalorian-and-grogu-sets-a-rotten-tomatoes-audience-score-record/",
            "image": "https://imageio.forbes.com/specials-images/imageserve/68d1500a4827d760fb83a16b/0x0.jpg?format=jpg&height=900&width=1600&fit=bounds",
            "publishedAt": "2026-05-22T13:33:49Z",
            "lang": "en",
            "source": {
                "id": "c4e32b557a3dd75225975f11fb68a3a9",
                "name": "Forbes",
                "url": "https://www.forbes.com"
            }
        },
        {
            "id": "fe94e611316420a15552db0bd68ed335",
            "title": "All charges against Chicago protesters dropped in latest ICE case to unravel",
            "description": "Prosecutors may face sanctions over redactions to grand jury transcripts linked to four of ‘Broadview Six’ defendants",
            "content": "Federal prosecutors have decided to drop all remaining criminal charges against four people indicted in October after protesting outside a suburban Chicago immigration detention center in the latest such case to unravel for the Trump administration.\n... [4256 chars]",
            "url": "https://www.theguardian.com/us-news/2026/may/22/chicago-ice-protesters-charges-dropped-broadview-six",
            "image": "https://i.guim.co.uk/img/media/0122fd9cb4bc216223c56457c1e54d2032582002/248_0_2480_1984/master/2480.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=3ac63f1e776ba4b3eea63a07f2759634",
            "publishedAt": "2026-05-22T13:19:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "3fce8ea30955716ff7bd89784af64737",
            "title": "MLB Insider: Rival execs reveal what Detroit Tigers could get for Tarik Skubal",
            "description": "Robert Murray spoke with three MLB executives about what it would take to get Tarik Skubal away from the Detroit Tigers.",
            "content": "With the Detroit Tigers losing 14 of their last 16 games and falling to 20-31 and last place in the American League Central, the chatter around a potential Tarik Skubal blockbuster ahead of the Aug. 3 trade deadline will only increase.\nJon Heyman of ... [3624 chars]",
            "url": "https://fansided.com/mlb/mlb-insider-what-could-the-detroit-tigers-get-in-a-tarik-skubal-trade",
            "image": "https://images2.minutemediacdn.com/image/upload/c_crop,x_502,y_154,w_2530,h_1423/c_fill,w_1440,ar_1440:810,f_auto,q_auto,g_auto/images/GettyImages/mmsport/229/01ks7spnm6g9ywjwd5yg.jpg",
            "publishedAt": "2026-05-22T13:09:48Z",
            "lang": "en",
            "source": {
                "id": "730cd45348b9735c402a2cbd6b7f84a2",
                "name": "FanSided",
                "url": "https://fansided.com"
            }
        }
    ]
}

Categories