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": 394720,
    "articles": [
        {
            "id": "6a8525b7891c6796e76a82361d13e65b",
            "title": "Blizzard Live Updates: Record Snowfall Slams New England as NYC and NJ Dig Out",
            "description": "Three feet of snow fell in parts of southern Rhode Island, where treacherous conditions forced a halt to snow removal in Providence. Massachusetts officials said more than 350 vehicles were stranded.",
            "content": "The cavernous hall, which had been all but empty in the morning, steadily became busier throughout the day as commuters hoped to catch a train out.\nThey sat on suitcases, hunched over laptops trying to work or idled in front of departure screens. A v... [18507 chars]",
            "url": "https://www.nytimes.com/live/2026/02/23/weather/nyc-snow-storm",
            "image": "https://static01.nyt.com/images/2026/02/23/multimedia/23winter-storm-promo-4pm-wmvz/23winter-storm-promo-4pm-wmvz-facebookJumbo.jpg",
            "publishedAt": "2026-02-23T23:16:27Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "751e77e8ce201eebf69898536d42d4e0",
            "title": "‘Death to the dictator’: Iranian students hold protests for third day",
            "description": "Demonstrations spread to Tehran’s Al Zahra University one month after security crackdown left thousands dead",
            "content": "Students at universities in Iran have held a third consecutive day of protests just over a month after the violent suppression by security services of mass street demonstrations left thousands dead.\nThe protests came amid tensions between Iran and th... [4942 chars]",
            "url": "https://www.theguardian.com/world/2026/feb/23/death-to-dictator-iranian-students-protests-third-day",
            "image": "https://i.guim.co.uk/img/media/fd11c9ba5ef2c7c7200c7f9a1846be9479676b98/0_0_2504_2003/master/2504.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=07ec8c2a04f86c7963720ba5726c9cbf",
            "publishedAt": "2026-02-23T21:19:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "004689aa5aee96f0a775283a22a27dbc",
            "title": "Blizzard live updates: More than 40 million people under warnings as winter storm dumps over 2 feet of snow across Northeast",
            "description": "This could rank in New York City's top 10 worst storms in 150 years.",
            "content": "A blizzard continues to pummel the Northeast on Monday morning, leaving more than 40 million people under warnings as heavy snowfall and hurricane-force winds bear down.\nOver 2 feet of snow has been reported by the National Weather Service in parts o... [771 chars]",
            "url": "https://www.yahoo.com/news/weather-news/live/blizzard-live-updates-more-than-40-million-people-under-warnings-as-winter-storm-dumps-over-2-feet-of-snow-across-northeast-152258583.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/0LX2sZNKafvJxDFEgb5u3w--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://d29szjachogqwa.cloudfront.net/images/user-uploaded/ap26054502674350_3730.jpg",
            "publishedAt": "2026-02-23T21:16:29Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        }
    ]
}

Categories