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": 522380,
    "articles": [
        {
            "id": "5797556f81c5ff4c25d59b8d9f592476",
            "title": "3 things to watch in Spurs-Timberwolves Game 3",
            "description": "Both teams look to sprint out of the gates in Game 3 while San Antonio attempts to grab back home-court advantage.",
            "content": "• Download the NBA App\nThirty-eight points normally is enough to win an entire playoff series and clearly overkill for any single game. Consider, a year ago, the Minnesota Timberwolves beat Golden State in the Western Conference semifinals by a total... [4813 chars]",
            "url": "https://www.nba.com/news/3-things-to-watch-spurs-timberwolves-game-3",
            "image": "https://cdn.nba.com/manage/2026/05/edwards-sas1.jpg",
            "publishedAt": "2026-05-09T06:00:34Z",
            "lang": "en",
            "source": {
                "id": "51615c5a3110b6568c3cd6f1dae8903b",
                "name": "NBA",
                "url": "https://www.nba.com"
            }
        },
        {
            "id": "52f38fe8e9a4fe5530b09c281bf74ace",
            "title": "New York Knicks vs. Philadelphia 76ers Live Score and Stats",
            "description": "Get real-time NBA Basketball coverage and scores as New York Knicks takes on Philadelphia 76ers. We bring you the latest game previews, live stats, expert picks and recaps on CBSSports.com",
            "content": "PHILADELPHIA (AP) Jalen Brunson scored 33 points and sealed the game with big buckets late to the delight of roaring New York Knicks fans, leading New York to a 108-94 win over the Philadelphia 76ers on Friday night for a 3-0 lead in the Eastern Conf... [3218 chars]",
            "url": "https://www.cbssports.com/nba/gametracker/recap/NBA_20260508_NY@PHI/",
            "image": "https://sportsfly.cbsistatic.com/fly-573/bundles/sportsmediacss/images/fantasy/default-article-image-large.png",
            "publishedAt": "2026-05-09T04:44:30Z",
            "lang": "en",
            "source": {
                "id": "416e66c8ea979965c0cee3b0ed1f714b",
                "name": "CBS Sports",
                "url": "https://www.cbssports.com"
            }
        },
        {
            "id": "d17487e5713b9ea46b3d032de48be905",
            "title": "Victor Wembanyama drops 39 points as Spurs take 2-1 lead over Timberwolves",
            "description": "Wembanyama posted a playoff stat line only seen from Shaquille O'Neal, Hakeem Olajuwon and Kareem Abdul-Jabbar.",
            "content": "The Minnesota Timberwolves didn’t make it easy, but the San Antonio Spurs have a 2-1 lead.\nBehind a superb night from Victor Wembanyama, the Spurs posted a 115-108 win in Game 3 on Friday to put their opponent on the ropes in the Western Conference s... [1910 chars]",
            "url": "https://sports.yahoo.com/nba/article/victor-wembanyama-drops-39-points-as-spurs-take-2-1-lead-over-timberwolves-043051376.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/Z_PzMh2eSS9oU.EsqrUAmQ--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://d29szjachogqwa.cloudfront.net/images/2026-05/07ff5651-fcb8-4c85-84f1-25d05464320c",
            "publishedAt": "2026-05-09T04:31:23Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        }
    ]
}

Categories