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": 198712,
    "articles": [
        {
            "id": "5f764dff4518e713f3233cacb9895778",
            "title": "Iran plans permanent break from global internet, say activists",
            "description": "Report claims unrestricted online access will be a ‘government privilege’, limited to individuals vetted by regime",
            "content": "Iran is planning to permanently break from the global internet, only allowing individuals vetted by the regime to connect online, according to Iranian digital rights activists.\n“A confidential plan is under way to turn international internet access i... [5970 chars]",
            "url": "https://www.theguardian.com/world/2026/jan/17/iran-plans-permanent-break-from-global-internet-say-activists",
            "image": "https://i.guim.co.uk/img/media/f78312c6a16635020bafa4fa6f6b92cb77075db0/616_0_4354_3483/master/4354.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=f4254a81e2961503243a6b1a0e793b95",
            "publishedAt": "2026-01-17T05:00:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "73748bca53d19b450bcedfa3a959dd1f",
            "title": "FAA urges pilots to exercise caution over eastern Pacific",
            "description": "The Federal Aviation Administration is urging U.S. aircraft operators to “exercise caution” when flying over the eastern Pacific Ocean near Mexico, Central America and parts of South America, citing “military activities” and satellite navigation interference.",
            "content": "The Federal Aviation Administration on Friday urged U.S. aircraft operators to “exercise caution” when flying over the eastern Pacific Ocean near Mexico, Central America and parts of South America, citing “military activities” and possible satellite ... [1072 chars]",
            "url": "https://apnews.com/article/faa-flight-warnings-pacific-ocean-dd0cbe105d75f6d8acf16f02884865c0",
            "image": "https://dims.apnews.com/dims4/default/15cc06a/2147483647/strip/true/crop/6720x3780+0+350/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F72%2Fa2%2F36b963ad3c90a36f95ad11332e28%2Ff09becf72c524d959b1aba355faa9483",
            "publishedAt": "2026-01-17T03:24:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "59b4e9fe9e3b5bcbfc11da2ab71b59f6",
            "title": "Trump threatens tariffs on nations that ‘don’t go along’ with Greenland plans",
            "description": "The president’s comments come as a group of bipartisan lawmakers are on an official visit to Denmark — with the aim to show U.S. support for the NATO ally despite the administration’s push to annex the territory.",
            "content": "The president’s comments come as a group of bipartisan lawmakers are on an official visit to Denmark — with the aim to show U.S. support for the NATO ally despite the administration’s push to annex the territory.\nUpdated\nJanuary 16, 2026 at 6:06 p.m.... [326 chars]",
            "url": "https://www.washingtonpost.com/politics/2026/01/16/trump-greenland-tariffs-congress-denmark/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/7VJSBD6MSFJVEREUKG2RVENAWA.JPG&w=1440",
            "publishedAt": "2026-01-17T02:11:32Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories