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": 385368,
    "articles": [
        {
            "id": "f1eef94b1b812d02816565cf508bfbc3",
            "title": "The Oscars will abandon broadcast TV for YouTube starting in 2029",
            "description": "The Oscars telecast will move from broadcasting to streaming in 2029, switching from ABC to YouTube — a watershed moment for the entertainment business.",
            "content": "The Oscars telecast will move from broadcasting to streaming in 2029, switching from ABC to YouTube — a watershed moment for the entertainment business.\nThe Academy of Motion Picture Arts and Sciences said Wednesday that YouTube signed a “multi-year ... [2137 chars]",
            "url": "https://www.cnn.com/2025/12/17/media/oscars-youtube-academy-awards-abc",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/2016-02-27t120000z-1047523370-gf10000325443-rtrmadp-3-awards-oscars.JPG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-12-17T18:06:31Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "f16ef54d26a2a1e1afa08b8ea394163a",
            "title": "Here's their locations",
            "description": "One of the tankers, Skipper, was seized by American forces in the Caribbean last week in a sharp escalation by the Trump administration.",
            "content": "At least 34 U.S.-sanctioned oil tankers with a history of carrying Venezuelan oil are currently at sea in the Caribbean, according to a new analysis obtained by CNBC on Wednesday.\nAnd at least 12 of those tankers appear to be filled with crude oil fr... [2777 chars]",
            "url": "https://www.cnbc.com/2025/12/17/trump-venezuela-tankers-oil.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108240057-1765392638190-gettyimages-2248656870-VENEZUELA_AIRSPACE.jpeg?v=1765991656&w=1920&h=1080",
            "publishedAt": "2025-12-17T17:04:08Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        },
        {
            "id": "d946063ce46cc979c9cac30074b73ffd",
            "title": "US tech stocks slide as Oracle data centre setback reignites AI concerns",
            "description": "Software giant suffers renewed declines after backer Blue Owl pulls out of $10bn project",
            "content": "US tech stocks fell on Wednesday, as news that Oracle has lost a key backer for a data centre project reignited investor concerns over soaring spending by artificial intelligence companies and the debt that is funding it.\nThe tech-heavy Nasdaq Compos... [1629 chars]",
            "url": "https://www.ft.com/content/ce60f74f-ccc8-4bde-bbec-842041ecf8e7",
            "image": "https://images.ft.com/v3/image/raw/https%3A%2F%2Fd1e00ek4ebabms.cloudfront.net%2Fproduction%2F55166eae-df57-4378-863e-5311bebc0548.jpg?source=next-article&fit=scale-down&quality=highest&width=700&dpr=1",
            "publishedAt": "2025-12-17T16:59:15Z",
            "lang": "en",
            "source": {
                "id": "d922e72550911d33239ec0ae33b2a143",
                "name": "Financial Times",
                "url": "https://www.ft.com"
            }
        }
    ]
}

Categories