Flag of the 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": 3593842,
    "articles": [
        {
            "id": "46fc7644bbae1180447d8a19f2ba91d9",
            "title": "Trump, Zelenskyy open to Putin talks as Europe pushes ceasefire: Live updates",
            "description": "Trump and Ukraine's Volodymyr Zelenskyy are meeting with European leaders and NATO allies in an unprecedented effort to reach a peace deal in Russia's invasion.",
            "content": "German Chancellor Friedrich Merz attends a meeting with U.S. President Donald Trump, Ukrainian President Volodymyr Zelenskiy and other European leaders amid negotiations to end the Russian war in Ukraine, at the White House in Washington, D.C., U.S.,... [962 chars]",
            "url": "https://www.cnbc.com/2025/08/18/trump-zelenskyy-ukraine-putin-live-updates.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108187632-1755543908713-gettyimages-2230838257-wm028421_fhmeyca7.jpeg?v=1755544010&w=1920&h=1080",
            "publishedAt": "2025-08-18T19:42:00Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com",
                "country": "us"
            }
        },
        {
            "id": "1d0093d7f6c365610c59fd6d70b52f6a",
            "title": "Hamas says it agrees to latest ceasefire proposal as mediators scramble for deal",
            "description": "Jerusalem confirms it got latest proposal from Hamas, as a dismissive Netanyahu says reports only reveal that 'Hamas is under immense pressure' due to IDF plan to conquer Gaza City",
            "content": "Hamas on Monday informed mediators that it accepted the ceasefire-hostage release deal proposal that was submitted to the group a day earlier, which sources said involves a 60-day pause and the release of 10 living captives, as mediators scramble to ... [8465 chars]",
            "url": "https://www.timesofisrael.com/hamas-says-it-agrees-to-latest-ceasefire-proposal-as-mediators-scramble-for-deal/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2025/08/AFP__20250818__69TU763__v1__HighRes__PalestinianIsraelConflict.jpg",
            "publishedAt": "2025-08-18T18:21:19Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com",
                "country": "us"
            }
        },
        {
            "id": "a6da1e137e7f685da351e9acac815f81",
            "title": "Trump Snubs Greatest Allies With Greeting From Fox News Star",
            "description": "European leaders arriving at the White House were met by the Chief of Protocol, Monica Crowley.",
            "content": "After rolling out the red carpet for Vladimir Putin in Alaska on Friday, President Donald Trump did not directly greet European leaders arriving at the White House on Monday.\nSeven European leaders including British Prime Minister Keir Starmer, Europ... [3506 chars]",
            "url": "https://www.thedailybeast.com/trump-snubs-greatest-allies-with-greeting-from-fox-news-host/",
            "image": "https://www.thedailybeast.com/resizer/v2/5DWJN7DOAJGM5DNIEIB32FLU24.jpg?smart=true&auth=fed51e5f7d8905b63aed99cbbdb1ab45aec6c664cd1d8eeacd841ddc42a6f852&width=1200&height=630",
            "publishedAt": "2025-08-18T17:37:00Z",
            "lang": "en",
            "source": {
                "id": "e3fd974e36370d094fc026102a75c80f",
                "name": "The Daily Beast",
                "url": "https://www.thedailybeast.com",
                "country": "us"
            }
        }
    ]
}

Categories