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": 3240946,
    "articles": [
        {
            "id": "82722bd828a9a1ed1d74ef38a20faa27",
            "title": "Scientists say they've found the world's oldest mummies, and they're far from Egypt",
            "description": "Mummies are most often associated with Egypt, where the oldest ones are about 4,500 years old. But researchers say they have found mummies that are much older, on the other side of the world.",
            "content": "Mummies are most often associated with Egypt, where the oldest ones are about 4,500 years old. But researchers say they have found mummies that are much older, on the other side of the world.\n“We found that in southern China and Southeast Asia, there... [2253 chars]",
            "url": "https://www.nbcnews.com/world/asia/scientists-say-found-worlds-oldest-mummies-far-egypt-rcna231558",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-09/250916-mummy-asia-mb-1113-d96ceb.jpg",
            "publishedAt": "2025-09-16T10:26:55Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com",
                "country": "us"
            }
        },
        {
            "id": "89f06961b75db99e5cccca55ae9985db",
            "title": "Israel begins ground offensive in Gaza City, as UN commission says Israel is committing genocide",
            "description": "Israel’s ground incursion escalates its war in defiance of international condemnation and backlash from the families of hostages still held by Hamas. Follow for live updates",
            "content": "The Israeli military called on residents to evacuate Gaza City, saying it is destroying Hamas infrastructure in the enclave’s largest urban center.\nThe IDF instructed residents to move “as quickly as possible” through Al-Rashid Street and toward sout... [9384 chars]",
            "url": "https://www.cnn.com/world/live-news/israel-hamas-war-gaza-city-incursion-09-16-25-intl-hnk",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gaza-city-displaced-citizens-thumb.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-09-16T07:07:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com",
                "country": "us"
            }
        },
        {
            "id": "4675950c56c3de9e2a327cf8da448b79",
            "title": "Poland’s president set to demand war reparations in tense Berlin visit",
            "description": "Tensions between Poland and Germany complicate the effort to show a united front against Russia’s Vladimir Putin.",
            "content": "BERLIN — It’s no secret that German Chancellor Friedrich Merz prefers to work with that other Polish leader, centrist Prime Minister Donald Tusk.\nBut on Tuesday he’ll be receiving Polish President Karol Nawrocki, a nationalist backed by the oppositio... [5336 chars]",
            "url": "https://www.politico.eu/article/poland-president-berlin-germany-visit-donald-tusk-friedrich-merz/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2025/09/16/GettyImages-2233986732-scaled.jpg",
            "publishedAt": "2025-09-16T03:00:00Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu",
                "country": "us"
            }
        }
    ]
}

Categories