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": 434944,
    "articles": [
        {
            "id": "a24eb359deafda469e82e78a4cdc9336",
            "title": "LIVE UPDATES: Top Iranian official eliminated in precision strike, Israeli official says",
            "description": "Iran’s Minister of Intelligence Esmaeil Khatib was killed overnight in a precision strike, a senior Israeli official said. His targeting was a joint U.S. and Israeli effort as Operation Epic Fury and Operation Roaring Lion continue.",
            "content": "3 hours ago\nPinned\nTrump warns US would ‘blow up’ Iran gas field if Qatar facility hit again\nPresident Donald Trump said Wednesday the U.S. “knew nothing” about Israel’s strike on a major Iranian gas field, but warned the U.S. would “blow up the enti... [44636 chars]",
            "url": "https://www.foxnews.com/live-news/us-iran-israel-war-latest-march-18-live-updates",
            "image": "https://assets.foxnews.com/liveblog/fn/prod/images/2026/03/ae4cc9ae26a41f716159b42510507ac8.jpg",
            "publishedAt": "2026-03-19T05:21:14Z",
            "lang": "en",
            "source": {
                "id": "a8408ad388422503ac33101396026891",
                "name": "Fox News",
                "url": "https://www.foxnews.com"
            }
        },
        {
            "id": "7488554d6bda3205ae0fdcfaa7f221a5",
            "title": "A real possum appears among plush toy animals in Australian airport shop",
            "description": "On shelves crammed with cuddly toy native animals in an Australian airport gift shop, one fluffy possum stood out because its brown eyes were moving.",
            "content": "MELBOURNE, Australia (AP) — On shelves crammed with cuddly toy native animals in an Australian airport gift shop, one fluffy possum stood out: Its big brown eyes were moving.\nA browsing passenger first spotted a living Australian brushtail possum pee... [1348 chars]",
            "url": "https://apnews.com/article/australia-airport-possum-toys-hobart-shop-c75cdac08eded76b93b4a33191fca56b",
            "image": "https://dims.apnews.com/dims4/default/bdd0b5b/2147483647/strip/true/crop/2392x1594+0+698/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fa9%2F19%2F1e1b51085cfd0e6ad46ecde2094b%2Ff2b44853490b4633989f67829c2dff08",
            "publishedAt": "2026-03-19T05:12:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "2bf7625f9fad7291e7dbc54fd620feea",
            "title": "First Four: Miami (Ohio) advances to face Tennessee; Dontae Horne, Prairie View sinks Lehigh",
            "description": "No. 11 seed RedHawks have lost just once this season, but now must face a No. 6 seed out of the SEC.",
            "content": "After Miami (Ohio) lost to UMass in the Mid-American Conference tournament quarterfinal, many questioned whether the RedHawks deserved a spot in the NCAA Tournament, even though that was their only loss of the season.\nA bid to the First Four in hand,... [6552 chars]",
            "url": "https://www.nytimes.com/athletic/7129676/2026/03/18/march-madness-2026-mens-first-four-score-results/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/03/18225254/GettyImages-2267306820-scaled.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-03-19T04:59:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories