Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 228326,
    "articles": [
        {
            "id": "5d869b1b3e93cb147205b8fac5b653bf",
            "title": "Iran hits Kuwait airport and a tanker off Qatar while strikes batter Tehran",
            "description": "Iran has hit an oil tanker off the coast of Qatar and Kuwait’s airport. Airstrikes meanwhile have battered Tehran. The unrelenting tempo continued hours after U.S.",
            "content": "DUBAI, United Arab Emirates (AP) — Iran hit an oil tanker off the coast of Qatar and Kuwait’s airport on Wednesday while airstrikes battered Tehran — an unrelenting tempo hours after U.S. President Donald Trump said he was nearly ready to wind down t... [5629 chars]",
            "url": "https://apnews.com/article/iran-us-israel-trump-lebanon-april-1-2026-19cf516c2d2c614eb182dbad7a6592ef",
            "image": "https://dims.apnews.com/dims4/default/bf39c79/2147483647/strip/true/crop/5000x3332+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ff3%2F5f%2Fa4a01b59a0ea9ed3d0c9754d7f83%2F67e1d71df4ca47bea1ac75f1cd6e1054",
            "publishedAt": "2026-04-01T09:55:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "36d6a55c4f7f601ba542ba1a3d4ae06c",
            "title": "Russian military plane crash in Crimea kills 29 people",
            "description": "A Russian military plane has crashed in annexed Crimea, killing six crew and 23 passengers on board.",
            "content": "MOSCOW (AP) — A Russian military plane crash in annexed Crimea has killed six crew and 23 passengers, Russian news agencies reported in the early hours of Wednesday, citing the Defense Ministry.\nThe An-26 military transport plane was carrying out a s... [1247 chars]",
            "url": "https://apnews.com/article/russia-crimea-plane-crash-3f45321e150f091583b8ba6c71c09586",
            "image": "https://dims.apnews.com/dims4/default/4228092/2147483647/strip/true/crop/4862x3240+319+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fb1%2F3a%2F890d12a2ee536178d0ce424614d7%2Fa99ad780e8dd448caff23191da2c2a02",
            "publishedAt": "2026-04-01T09:16:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "apnews.com",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "7683e35ae4c1f80647c7bb804ce67a76",
            "title": "Trump talks up U.S. exit from Iran within weeks as deal prospects emerge. Believable?",
            "description": "The comments lean mildly risk-negative for oil in the near term as they hint at de-escalation and reduced disruption risk in the region. However, credibility is uncertain, and any breakdown in talks could quickly reverse sentiment, keeping volatility elevated.",
            "content": "Summary:\nTrump signals a rapid U.S. exit from Iran within 2–3 weeks, citing progress and possible deal\nClaims “regime change already” suggests Washington sees objectives largely achieved\nComments contrast with earlier expectations of a longer militar... [2336 chars]",
            "url": "https://investinglive.com/commodities/trump-talks-up-us-exit-from-iran-within-weeks-as-deal-prospects-emerge-believable-20260331/",
            "image": "https://images.investinglive.com/images/Trump%20ground%20troops_id_ba0490bb-a3cc-4a87-b10e-f7e6432941a3_size975.jpg",
            "publishedAt": "2026-04-01T08:41:37Z",
            "lang": "en",
            "source": {
                "id": "6646fbe1e17181493308fc8de7f300ff",
                "name": "investingLive",
                "url": "https://investinglive.com"
            }
        }
    ]
}

Categories