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": 8073396,
    "articles": [
        {
            "id": "3bedd7ade5b7bdbaf9a0168cd9d24d6d",
            "title": "Portland, Oregon, has been in Trump’s sights for years. This is how we got here",
            "description": "The president has taken aim at some of the country’s largest Democratic-run cities, sending in federal officers and, in some cases, the US military to aid immigration enforcement and root out what he calls rampant crime. But one of his targets isn’t even among the country’s biggest 30 metro areas.",
            "content": "President Donald Trump has taken aim in his second term at some of the country’s largest Democratic-run cities – Chicago, Los Angeles, Washington, DC – sending in federal officers and, in some cases, the US military to aid immigration enforcement and... [8598 chars]",
            "url": "https://www.cnn.com/2025/10/09/us/portland-oregon-trump-history",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2239338526.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-10-09T08:00:53Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com",
                "country": "us"
            }
        },
        {
            "id": "b5058224be91d725e75a9cf26eb74f7c",
            "title": "ID photos of 70,000 users may have been leaked, Discord says",
            "description": "The platform says hackers targeted a firm that helped to verify the ages of its users.",
            "content": "Discord, a messaging platform popular with gamers, says official ID photos of around 70,000 users have potentially been leaked after a cyber-attack.\nThe platform, which has more than 200 million users worldwide, says hackers had targeted a firm that ... [1857 chars]",
            "url": "https://www.bbc.com/news/articles/c8jmzd972leo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/7ad5/live/f6fad0b0-a4af-11f0-bd4e-7755f432b75a.jpg",
            "publishedAt": "2025-10-09T06:45:00Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com",
                "country": "us"
            }
        },
        {
            "id": "e36830d11a57c8c4c4bbe706cde37b85",
            "title": "Yankees stunned as championship aspirations are dashed in ALDS",
            "description": "The Yankees believed this team was more talented and more complete than the club that went to the World Series a year ago, but they saw their season end Wednesday night in the ALDS.",
            "content": "NEW YORK -- Late Wednesday and into early Thursday, as clubhouse attendees taped together boxes for players to pack and everyone said their goodbyes for the winter, a sense of disbelief hovered over the New York Yankees.\nFrom manager Aaron Boone to s... [4007 chars]",
            "url": "https://www.espn.com/mlb/story/_/id/46539244/yankees-stunned-championship-aspirations-dashed-alds",
            "image": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2025%2F1009%2Fr1557759_1296x729_16%2D9.jpg",
            "publishedAt": "2025-10-09T06:45:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com",
                "country": "us"
            }
        }
    ]
}

Categories