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": 515272,
    "articles": [
        {
            "id": "0c7be1ee287486eb836069246620e6ae",
            "title": "98 Rockets (Apr 18, 2026) Game Recap",
            "description": "Expert recap and game analysis of the Los Angeles Lakers vs. Houston Rockets NBA game from April 18, 2026 on ESPN.",
            "content": "LOS ANGELES -- — Luke Kennard scored a career playoff-high 27 points, LeBron James had 19 points and 13 assists, and the short-handed Los Angeles Lakers capitalized on Kevin Durant's injury absence for a 107-98 victory over the Houston Rockets in the... [2329 chars]",
            "url": "https://www.espn.com/nba/recap/_/gameId/401869190",
            "image": "http://s.espncdn.com/stitcher/sports/basketball/nba/events/401869190.png?templateId=espn.com.share.1",
            "publishedAt": "2026-04-19T03:32:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "id": "cd53af2cfb82a72daff7fff73e82bed5",
            "title": "Kevin Durant (right knee) ruled out for Game 1 vs. Lakers",
            "description": "Kevin Durant ruled out after suffering injury in Wednesday practice, leaving his right knee 'tender and tough to bend in certain ways.'",
            "content": "LOS ANGELES (AP) — Kevin Durant was scheduled to miss the Houston Rockets’ playoff opener against the Los Angeles Lakers with a knee injury, leaving both teams without their top scorer to begin the first-round series.\nDurant was ruled out for Game 1 ... [1844 chars]",
            "url": "https://www.nba.com/news/kevin-durant-out-game-1",
            "image": "https://cdn.nba.com/manage/2026/04/GettyImages-2271454708-scaled-e1776554225480.jpg",
            "publishedAt": "2026-04-19T02:30:31Z",
            "lang": "en",
            "source": {
                "id": "51615c5a3110b6568c3cd6f1dae8903b",
                "name": "NBA",
                "url": "https://www.nba.com"
            }
        },
        {
            "id": "2582b82140f6234b7e54a860ebaa70e8",
            "title": "Atlanta Hawks vs. New York Knicks Live Score and Stats",
            "description": "Get real-time NBA Basketball coverage and scores as Atlanta Hawks takes on New York Knicks. We bring you the latest game previews, live stats, expert picks and recaps on CBSSports.com",
            "content": "NEW YORK (AP) Jalen Brunson scored 28 points, Karl-Anthony Towns had 19 of his 25 in the second half and the New York Knicks beat the Atlanta Hawks 113-102 on Saturday night in Game 1 of their Eastern Conference playoff series.\nOG Anunoby added 18 po... [1991 chars]",
            "url": "https://www.cbssports.com/nba/gametracker/recap/NBA_20260418_ATL@NY/",
            "image": "https://sportsfly.cbsistatic.com/fly-552/bundles/sportsmediacss/images/fantasy/default-article-image-large.png",
            "publishedAt": "2026-04-19T02:13:13Z",
            "lang": "en",
            "source": {
                "id": "416e66c8ea979965c0cee3b0ed1f714b",
                "name": "CBS Sports",
                "url": "https://www.cbssports.com"
            }
        }
    ]
}

Categories