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": 403608,
    "articles": [
        {
            "id": "6978447e313a9a8b47a7e0e9b2db773d",
            "title": "103 Spurs (Jan 11, 2026) Game Recap",
            "description": "Expert recap and game analysis of the Minnesota Timberwolves vs. San Antonio Spurs NBA game from January 11, 2026 on ESPN.",
            "content": "MINNEAPOLIS -- — Anthony Edwards banked in a go-ahead, 3-foot runner with 16.8 seconds and the Minnesota Timberwolves overcame a 19-point deficit to beat the San Antonio Spurs 104-103 on Sunday night.\nEdwards scored 23 points. Julius Randle had 15 po... [1607 chars]",
            "url": "https://www.espn.com/nba/recap?gameId=401810407",
            "image": "http://s.espncdn.com/stitcher/sports/basketball/nba/events/401810407.png?templateId=espn.com.share.1",
            "publishedAt": "2026-01-12T03:11:15Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "id": "b94628110c7a0ae13495aa089e2f5ffc",
            "title": "Patriots vs. Chargers score: New England wins first playoff game since 2018",
            "description": "Drake Maye made just enough plays to outlast an undermanned Chargers squad led by Justin Herbert",
            "content": "The AFC wild card game matchup in Foxborough against the second-seeded New England Patriots and the seventh-seeded Los Angeles Chargers ended up being a defensive battle where it seemed like the first team to score a touchdown would win the game. New... [13271 chars]",
            "url": "https://www.cbssports.com/nfl/news/patriots-vs-chargers-live-updates-score-highlights-nfl-wild-card-weekend/live/",
            "image": "https://sportshub.cbsistatic.com/i/r/2025/12/14/9cd52b0a-1c4d-4d3e-a4aa-42a5b440b692/thumbnail/1200x675/81539b3a692ab18eb48ddbd3f9cb38e2/gettyimages-2251899707.jpg",
            "publishedAt": "2026-01-12T03:11:15Z",
            "lang": "en",
            "source": {
                "id": "416e66c8ea979965c0cee3b0ed1f714b",
                "name": "CBS Sports",
                "url": "https://www.cbssports.com"
            }
        },
        {
            "id": "cf453c21896836213b629b7eee5d7072",
            "title": "Los mejores looks en la alfombra roja de los Globo de Oro 2026",
            "description": "Desde el vestido de escote en V con lentejuelas de Marilyn Monroe hasta el vestido de gala azul lavanda de Lady Gaga, los premios Globo de Oro han ofrecido su dosis de glamour, brillo y atuendos impresionantes a lo largo de los años.",
            "content": "Desde el vestido de escote en V con lentejuelas de Marilyn Monroe hasta el vestido de gala azul lavanda de Lady Gaga, los premios Globo de Oro han ofrecido su dosis de glamour, brillo y atuendos impresionantes a lo largo de los años.\nEl domingo no de... [916 chars]",
            "url": "https://cnnespanol.cnn.com/2026/01/11/entretenimiento/globo-de-oro-mejores-looks-alfombra-roja-trax",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2255762329-20260111232014563.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-12T02:22:00Z",
            "lang": "es",
            "source": {
                "id": "3c9d862fa32f79b035b88873a5d21ccb",
                "name": "CNN en Español",
                "url": "https://cnnespanol.cnn.com"
            }
        }
    ]
}

Categories