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": 386072,
    "articles": [
        {
            "id": "3b739f5aee0de705613c19dcd404287d",
            "title": "Body of rapper Lil Jon's son found in Georgia pond days after he went missing",
            "description": "The body of rapper Lil Jon's 27-year-old son was found near his Georgia home days after he was reported missing, police and his family said.",
            "content": "The body of rapper Lil Jon's 27-year-old son was found near his Georgia home days after he was reported missing, police and his family said.\nNathan Smith, who goes by the name DJ Young Slade, was reported missing Tuesday morning after he was last see... [1870 chars]",
            "url": "https://www.nbcnews.com/news/us-news/body-believed-rapper-lil-jons-son-found-georgia-pond-days-went-missing-rcna257781",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-02/260206-young-slade-lil-jon-death-ww-1516-24923a.jpg",
            "publishedAt": "2026-02-06T21:26:33Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "dd033acd5f7431ff9bf387856f90ebd3",
            "title": "Austin Butler To Play Lance Armstrong In New Movie From Edward Berger",
            "description": "Austin Butler is attached to star as Lance Armstrong in new move that Edward Berger is directing.",
            "content": "EXCLUSIVE: Here is a package that has several major studios off to the races. Deadline is hearing that Austin Butler is attached to star in a movie about infamous cyclist Lance Armstrong, with Edward Berger on board to direct. King Richard scribe Zac... [3624 chars]",
            "url": "https://deadline.com/2026/02/austin-butler-lance-armstrong-movie-edward-berger-1236708342/",
            "image": "https://deadline.com/wp-content/uploads/2026/02/Austin-Butler-Edward-Berger-Scott-Stuber-and-Lance-Armstrong.jpg?w=1024",
            "publishedAt": "2026-02-06T20:00:00Z",
            "lang": "en",
            "source": {
                "id": "079303dd146f0fcdde881d709e8dbdf4",
                "name": "Deadline",
                "url": "https://deadline.com"
            }
        },
        {
            "id": "40bdc47ab50d86afb447de59a082afbe",
            "title": "Felony charge against top NHL prospect Gavin McKenna dropped",
            "description": "Penn State hockey star Gavin McKenna will have his felony aggravated assault charge dropped, the Centre County District Attorney's Office announced Friday.",
            "content": "Penn State hockey star Gavin McKenna will have his felony aggravated assault charge dropped, the Centre County District Attorney's Office announced Friday.\nMcKenna, the consensus first overall pick in this June's NHL draft, was charged on four counts... [2968 chars]",
            "url": "https://www.espn.com/nhl/story/_/id/47851034/felony-charge-top-nhl-prospect-gavin-mckenna-dropped",
            "image": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0106%2Fr1597342_1296x729_16%2D9.jpg",
            "publishedAt": "2026-02-06T19:40:45Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories