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": 551784,
    "articles": [
        {
            "id": "174dbf44271fbdb356bc0d6199a42f87",
            "title": "Crew Rescued After U.S. Helicopter Goes Down Near Strait of Hormuz",
            "description": "It was not immediately clear what led to the incident, which came at a time when the cease-fire in the war has grown tenuous.",
            "content": "A U.S. Army Apache helicopter gunship went down near the Strait of Hormuz on Monday, and the two crew members were safely rescued, according to two people briefed on the incident.\nIt was not immediately clear whether the Apache was shot down by Irani... [2689 chars]",
            "url": "https://www.nytimes.com/2026/06/08/us/politics/us-helicopter-strait-of-hormuz.html",
            "image": "https://static01.nyt.com/images/2026/06/08/multimedia/08dc-military-iran-mpck/08dc-military-iran-mpck-facebookJumbo-v2.jpg",
            "publishedAt": "2026-06-09T05:34:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "ad6b0f91101b2e6917ca99bc6fae6415",
            "title": "Some major earthquakes in the Philippines",
            "description": "Earthquakes are common in the Philippines, which lies on the Pacific “Ring of Fire,” the arc of seismic faults around the ocean where most of the world's earthquakes occur.",
            "content": "Earthquakes are common in the Philippines, which lies on the Pacific “Ring of Fire,” the arc of seismic faults around the ocean where most of the world’s earthquakes occur. Here’s a look at some recent quakes in the Philippines:\nJune 8, 2026: An offs... [1322 chars]",
            "url": "https://apnews.com/article/list-timeline-deadly-earthquakes-8805e25d26cbf11db02c00d6dec67a2b",
            "image": "https://dims.apnews.com/dims4/default/73cd02f/2147483647/strip/true/crop/3000x1999+0+126/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F5d%2F3f%2F94c69b734b2de09221c8cde8419e%2F7c23d80c3ee5461f83ef9da31a0bed36",
            "publishedAt": "2026-06-09T04:24:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "cf11fdd5006f824ff9a5257b5b55ba30",
            "title": "Wembanyama, Spurs stun Knicks in MSG to revive Finals hopes",
            "description": "Victor Wembanyama had 32 points, eight rebounds and six assists in his first NBA Finals win as the Spurs cut the series lead to 2-1.",
            "content": "NEW YORK -- Victor Wembanyama had 32 points, eight rebounds and six assists in his first NBA Finals win, carrying the San Antonio Spurs to a 115-111 victory on Monday night that cut the New York Knicks' lead to 2-1.\nThe Spurs handed the Knicks their ... [2501 chars]",
            "url": "https://www.espn.com/nba/story/_/id/49005881/wembanyama-spurs-stun-knicks-msg-revive-finals-hopes",
            "image": "https://a.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0609%2Fr1670106_1024x576_16%2D9.jpg",
            "publishedAt": "2026-06-09T03:43:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories