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": 259908,
    "articles": [
        {
            "id": "ef08ad0051711cb3728336469153bf1e",
            "title": "Iran war live updates",
            "description": "Vice President JD Vance canceled travel plans to Europe as officials on both sides are making it clear they will return to fighting if peace talks are not to their liking.",
            "content": "Israel and Hezbollah agreed to a ceasefire that will begin at 4 p.m. local time on Friday amid escalating violence between Israel and Lebanon that complicated President Donald Trump's efforts to reach a final peace agreement with Iran.\nStill, the nex... [9454 chars]",
            "url": "https://www.usatoday.com/story/news/world/2026/06/19/iran-war-trump-peace-us-updates--live/90615139007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/06/19/USAT/90618833007-20260619-t-113801-z-1704433536-rc-2-zwlahzhvt-rtrmadp-3-irancrisisisraellebanon.JPG?crop=5999,3375,x0,y312&width=3200&height=1801&format=pjpg&auto=webp",
            "publishedAt": "2026-06-19T15:54:00Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        },
        {
            "id": "2237270f24dabc63630fd20650dd13eb",
            "title": "How Ukraine broke through Russia’s air defenses",
            "description": "As a barrage of Ukrainian drones descended on Moscow in the early hours of Thursday, Russia’s response appeared more like a scramble, and less like a well-planned strategic defense. Videos from the streets of the capital showed glimpses of the ensuing chaos.",
            "content": "As a barrage of Ukrainian drones descended on Moscow in the early hours of Thursday, Russia’s response appeared more like a scramble, and less like a well-planned strategic defense. Videos from the streets of the capital showed glimpses of the ensuin... [5523 chars]",
            "url": "https://www.cnn.com/2026/06/19/europe/ukraine-broke-through-russias-air-defenses-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/still-22730451-32148-000000000004-still.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-06-19T15:43:44Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "907bc995a88743721b85b35446f64a8a",
            "title": "‘Destruction is the goal’: Israel steers between the US, Iran, and Lebanon",
            "description": "Netanyahu faces political backlash and US criticism as Israeli attacks on Lebanon defy Iran peace agreement.",
            "content": "Israeli Prime Minister Benjamin Netanyahu has restrained himself from openly displaying his opposition to the memorandum of understanding between Iran and the United States. But looking to the positions of Israelis from across the political spectrum,... [5316 chars]",
            "url": "https://www.aljazeera.com/news/2026/6/19/destruction-is-the-goal-israel-steers-between-the-us-iran-and-lebanon",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/04/2026-04-14T124930Z_1264643327_RC2CAJAN7KMZ_RTRMADP_3_IRAN-CRISIS-ISRAEL-1776395360.jpg?resize=1920%2C1440",
            "publishedAt": "2026-06-19T15:27:18Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        }
    ]
}

Categories