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": 550878,
    "articles": [
        {
            "id": "a41f0b6264240891ecda616808b1187f",
            "title": "Iran War Live Updates: U.S. and Iran Trade Fresh Attacks",
            "description": "The continued exchanges of fire have raised fears that the two sides could return to all-out war.",
            "content": "The American attack began shortly after midnight in Tehran, according to the U.S. military’s Central Command. Explosions were heard in Qeshm near the Strait of Hormuz, as well as the southern cities of Bandar Abbas, Minab and Sirik, Iranian news outl... [7108 chars]",
            "url": "https://www.nytimes.com/live/2026/06/11/world/iran-war-trump-us-israel",
            "image": "https://static01.nyt.com/images/2026/06/11/multimedia/11mideast-promo-mckj/11mideast-promo-mckj-facebookJumbo.jpg",
            "publishedAt": "2026-06-11T06:48:44Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "f13169b8ce73451c96676586f3a1f135",
            "title": "NBA Finals: Epic collapse leaves Victor Wembanyama, Spurs searching for answers",
            "description": "OG Anunoby's tip-in with 1.2 seconds left in regulation was technically the game-winner, but San Antonio accepted defeat long before that.",
            "content": "NEW YORK — \"There is an unraveling, a great unraveling that I believe is occurring. Not without its pain, not without its frustration.\" — Terry Tempest Williams\nWith seconds remaining Wednesday night, as an island of silver and black engulfed in the ... [5309 chars]",
            "url": "https://sports.yahoo.com/nba/article/nba-finals-epic-collapse-leaves-victor-wembanyama-spurs-searching-for-answers-050713100.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/9O7X0Ijc8yvv7HUpozxetg--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://d29szjachogqwa.cloudfront.net/images/2026-06/a1ad504b-2295-4daa-8dfc-beeda6dd19e7",
            "publishedAt": "2026-06-11T05:07:00Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        },
        {
            "id": "7f542f27a275f018d87672933adff191",
            "title": "Knicks stage historic Game 4 comeback against Spurs, 1 win away from title",
            "description": "The Spurs had a 29-point second-half lead. By the final buzzer, the Knicks had erased it to go up 3-1 in the NBA Finals.",
            "content": "NEW YORK — OG Anunoby soared from — where? Maybe the Empire State Building? — for the greatest put-back in New York Knicks history, finishing off the biggest in-game comeback in NBA Finals history and moving the New York Knicks to within one win of t... [8876 chars]",
            "url": "https://www.nytimes.com/athletic/7349256/2026/06/10/knicks-spurs-nba-finals-game-4-score-results-takeaways/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/06/10233314/GettyImages-2280350223-scaled.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-06-11T04:49:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories