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": 548658,
    "articles": [
        {
            "id": "494402f08b15c33efeb8a748b89ec3de",
            "title": "Xi Jinping will travel to North Korea next week in his first visit since 2019",
            "description": "Chinese leader Xi Jinping will travel to North Korea next week in what will be his first visit in years.",
            "content": "BEIJING (AP) — Chinese leader Xi Jinping will travel to North Korea next week, both countries announced Friday, in what will be his first visit in nearly seven years.\nHis trip will be the latest in a series of steps by China to reinforce its close ti... [3955 chars]",
            "url": "https://apnews.com/article/china-xi-north-korea-kim-4def48720a7cb66f820d3efc256a941c",
            "image": "https://dims.apnews.com/dims4/default/c4f01f6/2147483647/strip/true/crop/5031x3352+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ffc%2Fe5%2Fbd28a6855fbdac6395add9673fd3%2Fffaa2e95d25448c69e5c1003770a6e8a",
            "publishedAt": "2026-06-05T07:59:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "6b0819555cb773c9955fb10da1693c1c",
            "title": "'Scary Movie' $7.5M, 'Masters of the Universe' $4M Previews",
            "description": "'Scary Movie' is posting a strong $7.5M in Thursday night previews while 'Masters of the Universe' is doing $4M.",
            "content": "EXCLUSIVE: Paramount-Miramax’s reboot Scary Movie as of right now is having the first laugh (and ultimately the last) at the box office, and big, with an estimated $7.5M in previews that began at 2PM today. Meanwhile, Amazon MGM Studios’ $170M produc... [1418 chars]",
            "url": "https://deadline.com/2026/06/box-office-scary-movie-masters-of-the-universe-backrooms-1236941701/",
            "image": "https://deadline.com/wp-content/uploads/2026/06/Scary-Movie-and-Masters-of-the-Universe.jpg?w=1024",
            "publishedAt": "2026-06-05T05:49:00Z",
            "lang": "en",
            "source": {
                "id": "079303dd146f0fcdde881d709e8dbdf4",
                "name": "Deadline",
                "url": "https://deadline.com"
            }
        },
        {
            "id": "d43dc4c613be4dba34bf8e7a5396f0b6",
            "title": "Stanley Cup Final Game 2: Key takeaways as Hurricanes stun Golden Knights to tie series",
            "description": "Seth Jarvis scored the game-winning PP goal in OT to lift Carolina to a thrilling 4-3 victory over Vegas in Game 2 of the Stanley Cup Final.",
            "content": "RALEIGH, N.C. — For more than 50 minutes on Thursday night, the Carolina Hurricanes looked like a team running out of time. Now they’ve turned the Stanley Cup Final into a best-of-five, rallying from a two-goal deficit and beating the Vegas Golden Kn... [9707 chars]",
            "url": "https://www.nytimes.com/athletic/7334423/2026/06/04/hurricanes-golden-knights-stanley-cup-final-game-2-score-result-takeaways/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/06/04235227/GettyImages-2279913836-scaled-e1780631560233.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-06-05T04:58:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories