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": 202426,
    "articles": [
        {
            "id": "8f72d93b6c5f4fab133fc0c73316a9ae",
            "title": "The US is taking control of Venezuela and targeting Greenland. The Dow could still hit 50,000",
            "description": "The United States attacked Venezuela and President Donald Trump is threatening to take Greenland “the hard way.” All the while, the US has an uncertain economic outlook and a weak jobs report.",
            "content": "The United States attacked Venezuela and President Donald Trump is threatening to take Greenland “the hard way.” All the while, the US has an uncertain economic outlook and a weak jobs report.\nBut the Dow Jones Industrial Average could still hit a re... [4079 chars]",
            "url": "https://www.cnn.com/2026/01/11/business/dow-50000-record-venezuela-greenland-us",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap26008707074173.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-11T22:00:17Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "47665393f9c816b3bf022cdf23b2085c",
            "title": "Human heads displayed at Ecuador tourist beach in warning to gangs",
            "description": "Images on social media showed five heads tied with ropes on two wooden posts at a popular whale watching destination in Ecuador's southwest.",
            "content": "Five human heads were found hung on display at a tourist beach in Ecuador on Sunday, police said, as the country feels from a wave of gang violence.\nImages on social media showed five heads tied with ropes on two wooden posts on the beach in Puerto L... [1190 chars]",
            "url": "https://www.cbsnews.com/news/human-heads-ecuador-beach-gang-violence/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/01/11/2186aa6a-ff09-4f23-85cf-f5128270e640/thumbnail/1200x630/3ea477176f059e2dc5fdd04317120afa/gettyimages-1726766315.jpg",
            "publishedAt": "2026-01-11T19:19:37Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "de00109762ee6a25f998054ac2e8599f",
            "title": "Deep freeze strands thousands in northern Finland",
            "description": "Thousands of tourists are stranded in northern Finland after flights at Kittilä airport were canceled due to severe cold",
            "content": "HELSINKI -- Thousands of tourists were stranded in northern Finland on Sunday after flights at Kittilä airport were canceled due to severe cold.\nThe temperature at the airport dropped to minus 37 degrees Celsius (minus 34.6 degrees Fahrenheit) on Sun... [1360 chars]",
            "url": "https://abcnews.go.com/International/wireStory/thousands-tourists-stranded-northern-finland-deep-freeze-halts-129104910",
            "image": "https://i.abcnewsfe.com/a/8357c960-3fc0-49df-afc9-b14eca02e50b/wirestory_c95ec0c51effea12b378e1af7408b754_16x9.jpg?w=1600",
            "publishedAt": "2026-01-11T18:55:10Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "abcnews.go.com",
                "url": "https://abcnews.go.com"
            }
        }
    ]
}

Categories