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": 84041,
    "articles": [
        {
            "title": "The Aga Khan IV, Leader of the Ismaili Muslims, Dies at 88",
            "description": "At the age of 20, he inherited the reins of a Shia Muslim lineage and used his entrepreneurship to become one of the world’s wealthiest hereditary rulers.",
            "content": "The Aga Khan IV, leader of the world’s Ismaili Muslims, who fused entrepreneurship and philanthropy to become one of the world’s wealthiest hereditary rulers, died on Tuesday in Lisbon. He was 88.\nHis death was confirmed by his Aga Khan Development N... [749 chars]",
            "url": "https://www.nytimes.com/2025/02/04/obituaries/the-aga-khan-iv-dead.html",
            "image": "https://static01.nyt.com/images/2025/02/04/multimedia/04Aga-Khan--jtmp/04Aga-Khan--jtmp-facebookJumbo.jpg",
            "publishedAt": "2025-02-04T22:23:02Z",
            "source": {
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "title": "As hundreds of quakes rattle Greek islands, a few brave tourists have Santorini to themselves",
            "description": "The mayor of Santorini says that the hundreds of earthquakes that have rattled Greek islands on the Aegean Sea are a “seismic swarm” and could continue for weeks before eventually diminishing.",
            "content": "SANTORINI, Greece (AP) — The hundreds of earthquakes that have rattled Greek islands on the Aegean Sea are a “seismic swarm” and could continue for weeks before eventually diminishing, the Santorini mayor told The Associated Press on Tuesday — pausin... [2419 chars]",
            "url": "https://apnews.com/article/greece-santorini-earthquakes-25df4b59f3c0f3c72d4cfc31f1e0034a",
            "image": "https://dims.apnews.com/dims4/default/377ada0/2147483647/strip/true/crop/8553x4811+0+445/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F57%2Fba%2Fdb1700304f9a8daa5d2346175465%2F57d946ef9b0e4b3d9a42e82d29dc95df",
            "publishedAt": "2025-02-04T18:59:00Z",
            "source": {
                "name": "The Associated Press",
                "url": "https://apnews.com"
            }
        },
        {
            "title": "Von der Leyen signals ‘extraordinary’ measure to boost EU defense spending",
            "description": "The move would offer national capitals more room to increase defense spending.",
            "content": "Von der Leyen told reporters she would \"use the full range that we have of flexibilities in the Stability and Growth Pact to allow for a significant increase in defense spending.”\nShe added: “For extraordinary times, it is possible to have extraordin... [942 chars]",
            "url": "https://www.politico.eu/article/eu-ursula-von-der-leyen-measures-boost-eu-defense-spending-commission/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2025/02/04/GettyImages-2196965476-scaled.jpg",
            "publishedAt": "2025-02-04T16:05:00Z",
            "source": {
                "name": "POLITICO Europe",
                "url": "https://www.politico.eu"
            }
        }
    ]
}

Categories