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": 424234,
    "articles": [
        {
            "id": "8194db8f0f7ad43e6c412647d8f38b6b",
            "title": "US allows Venezuela to sell more oil as Iran war boosts prices",
            "description": "The Treasury Department is easing sanctions on Venezuela’s state oil company. It's one way the Trump administration is trying to ease oil prices that have soared during the Iran war.",
            "content": "WASHINGTON (AP) — U.S. companies will be allowed to do business with Venezuela’s state-owned oil and gas company after the Treasury Department eased sanctions, with some limitations, on Wednesday as the Trump administration looks for ways to boost gl... [7442 chars]",
            "url": "https://apnews.com/article/trump-iran-war-venezuela-oil-supplies-prices-3a3ca446459b3ab0127c08ad0808cc15",
            "image": "https://dims.apnews.com/dims4/default/6d963e0/2147483647/strip/true/crop/3986x2656+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F63%2F58%2F864591e3129ee02f5885c8e33d5f%2Fa24d2960ae8a4d2eb9bbebb1fe3ca771",
            "publishedAt": "2026-03-18T20:11:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "7b06ea7de53c7555604d26b954251e41",
            "title": "Delcy Rodríguez destituye a Vladimir Padrino como ministro de Defensa de Venezuela",
            "description": "Delcy Rodríguez nombró como nuevo ministro de Defensa al general Gustavo González López.",
            "content": "Autor,\nTítulo del autor, BBC News Mundo\n18 marzo 2026, 18:08 GMT\nActualizado 1 hora\nTiempo de lectura: 5 min\nVladimir Padrino López, ministro de Defensa de Venezuela durante más de una década, fue destituido de su cargo este miércoles.\nLa presidenta ... [6089 chars]",
            "url": "https://www.bbc.com/mundo/articles/c8egegkpl0ro",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/bfdb/live/20cb91e0-22f5-11f1-8620-17795c093e86.jpg",
            "publishedAt": "2026-03-18T19:44:57Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "fe81143553c692c8940095717fcb4522",
            "title": "WNBA CBA live updates as league, players agree to deal in principle",
            "description": "The WNBA and WNBPA agreed in principle to a new CBA, which is expected to drive player salaries up nearly fourfold. Here are the latest updates.",
            "content": "After more than 17 months of negotiations, the WNBA and Women's National Basketball Players Association (WNBPA) agreed in principle to a new collective bargaining agreement on Wednesday, March 18, a person with knowledge of the situation confirmed to... [9762 chars]",
            "url": "https://www.usatoday.com/story/sports/wnba/2026/03/18/wnba-players-union-agreement-in-principle-new-cba/87154047007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/03/18/USAT/89211963007-usatsi-27012507.jpg?crop=6282,3534,x0,y219&width=3200&height=1801&format=pjpg&auto=webp",
            "publishedAt": "2026-03-18T19:24:21Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        }
    ]
}

Categories