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": 483214,
    "articles": [
        {
            "id": "56252f5165924065e5e757f97421fd36",
            "title": "Winners and losers from F1's fraught Japanese Grand Prix",
            "description": "As a scary accident for Oliver Bearman further exposed pain points in Formula 1's 2026 regulations, the fight for the 2026 world championship received several intriguing twists",
            "content": "Winner: Kimi Antonelli\nFew people would have bet against a Mercedes driver leading the standings after the opening leg of the season. But even fewer people would have gambled on Kimi Antonelli as Mercedes' lead driver three weekends into the season.\n... [5733 chars]",
            "url": "https://www.motorsport.com/f1/news/winners-losers-f1-fraught-japanese-grand-prix/10809460/",
            "image": "https://cdn-1.motorsport.com/images/amp/0rVxebJ0/s6/andrea-kimi-antonelli-mercedes.jpg",
            "publishedAt": "2026-03-29T11:16:56Z",
            "lang": "en",
            "source": {
                "id": "cc123e7554f2c698cb6a8a3c711bd28e",
                "name": "Motorsport.com",
                "url": "https://www.motorsport.com"
            }
        },
        {
            "id": "ebd87be1f04e914a24712201b6b775f3",
            "title": "North Korea conducts engine test for long-range missile",
            "description": "North Korea reports that Kim Jong Un watched a test of an upgraded solid-fuel engine for missiles that can reach the U.S. mainland.",
            "content": "SEOUL, South Korea (AP) — North Korean leader Kim Jong Un observed a test of an upgraded solid-fuel engine for weapons capable of reaching the U.S. mainland, and called it a significant development boosting his country’s strategic military arsenal, s... [3130 chars]",
            "url": "https://apnews.com/article/north-korea-kim-missile-engine-test-us-bdc130f08bed4fd569bdd041ce2c67aa",
            "image": "https://dims.apnews.com/dims4/default/2bb6074/2147483647/strip/true/crop/4966x3309+17+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F23%2Ff7%2F2ac335e29756b4886865f7a5c8a5%2F970f6f995b2b4f1db8d3b400345b6f4e",
            "publishedAt": "2026-03-29T10:51:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "11d62b818c7241cf431167478b225ce6",
            "title": "Pope Leo XIV denounces war justification at Palm Sunday Mass",
            "description": "Pope Leo XIV says no one can use God to justify war and he's praying especially for Christians in the Middle East.",
            "content": "ROME (AP) — Pope Leo XIV on Sunday rejected claims that God justifies war and prayed especially for Christians in the Middle East during a Palm Sunday Mass before tens of thousands of people in St. Peter’s Square.\nWith the U.S.-Israeli war on Iran en... [4197 chars]",
            "url": "https://apnews.com/article/vatican-palm-sunday-francis-pope-5749906e8c5d5303b1fb06e33607e062",
            "image": "https://dims.apnews.com/dims4/default/f39c01d/2147483647/strip/true/crop/2186x1457+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F09%2F8e%2Fde433ca31e3b8c183278e42b90de%2F5791cfc757134561b264490c6635ba2d",
            "publishedAt": "2026-03-29T10:39:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories