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": 446114,
    "articles": [
        {
            "id": "6ce2752f80417d8456b65d9631785e36",
            "title": "Average US gas prices soar past $4 a gallon",
            "description": "U.S. gas prices have jumped past an average of $4 a gallon for the first time since 2022 as fuel prices continue to soar worldwide amid the Iran war.",
            "content": "NEW YORK (AP) — U.S. gas prices jumped past an average of $4 a gallon for the first time since 2022 on Tuesday as the Iran war pushed fuel prices to soar worldwide.\nAccording to motor club AAA, the national average for a gallon of regular gasoline is... [4266 chars]",
            "url": "https://apnews.com/article/gas-prices-4-gallon-iran-war-de8b7ccea254a1585cab86f336db57a6",
            "image": "https://dims.apnews.com/dims4/default/dc0a5a7/2147483647/strip/true/crop/4703x3134+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F7a%2F86%2F26226050fe294cd87b7e7f47c595%2F3cb8601c8d18450388e46f7fe1708f34",
            "publishedAt": "2026-03-31T07:38:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "f0601fea3543e23475f01e5cc83667ff",
            "title": "U.S. Gas Prices Hit $4 a Gallon on Average",
            "description": "A month since the first U.S.-Israeli attacks and Iran’s response effectively shut off Persian Gulf oil, drivers are paying significantly more to fill up.",
            "content": "Gasoline in the United States crossed an average of $4 a gallon on Tuesday, a threshold it hadn’t reached since August 2022, continuing a series of nearly uninterrupted increases since the Middle East war began that are chipping away at the spending ... [1145 chars]",
            "url": "https://www.nytimes.com/2026/03/31/business/gas-prices-4-dollars-gallon-iran.html",
            "image": "https://static01.nyt.com/images/2026/03/20/multimedia/00biz-gas-hfo-tqwp/00biz-gas-hfo-tqwp-facebookJumbo.jpg",
            "publishedAt": "2026-03-31T07:27:02Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "fb99e157ec547521a9f3570b97bbba7b",
            "title": "Live updates: Iran war news, Kuwaiti oil tanker attack, Trump threatens Iran’s energy facilities",
            "description": "No oil leakage or injuries have been reported following the Iranian strike on the Kuwaiti tanker. Follow for live updates.",
            "content": "No oil leakage or injuries have been reported following the strike on a Kuwaiti tanker full of oil in Dubai waters, city authorities said Tuesday.\nEarlier, the Kuwait Petroleum Corporation warned of the possibility of an oil spill after the large cru... [11877 chars]",
            "url": "https://www.cnn.com/2026/03/31/world/live-news/iran-war-us-trump-oil",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/03-2026-03-04t182121z-2122628346-rc24vjaejhvb-rtrmadp-3-iran-crisis-1.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-31T05:31:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories