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": 225072,
    "articles": [
        {
            "id": "77c649a2d073e66c3ec000c697a7aadd",
            "title": "Wilmer Ruperti reaparece en redes sociales tras más de una semana detenido",
            "description": "El magnate petrolero Wilmer Ruperti reapareció recientemente en sus redes sociales tras pasar más de una semana bajo la custodia del Sebin",
            "content": "El magnate petrolero Wilmer Ruperti reapareció recientemente en sus redes sociales tras pasar más de una semana bajo la custodia del Servicio Bolivariano de Inteligencia Nacional (Sebin) en Caracas. A través de un video en Instagram, el empresario en... [1124 chars]",
            "url": "https://www.elnacional.com/2026/04/wilmer-ruperti-reaparece-en-redes-sociales-tras-mas-de-una-semana-detenido-por-el-sebin/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2026/04/02094831/2029523516261884257-72.png",
            "publishedAt": "2026-04-02T14:17:55Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        },
        {
            "id": "d2aa0780b5294cc292b6ff64ae0bf162",
            "title": "Iran executes protest detainee over Basij base fire case",
            "description": "Iran’s judiciary said on Thursday it had carried out the execution of Amirhossein Hatami, a protest detainee convicted in a case linked to a fire at a Basij base in Tehran during January protests.",
            "content": "Jafari, a fifth-grade student, was killed at a military checkpoint in Tehran during US and Israeli airstrikes targeting military sites, according to Hengaw, a Norway-based Kurdish human rights organization that monitors abuses in Iran.\nIn an intervie... [31820 chars]",
            "url": "https://www.iranintl.com/en/202604021945",
            "image": "https://i.iranintl.com/images/rdk9umy0/production/dbb1d0f209291754c0152626e4137f12f6473170-1088x944.jpg?rect=0,341,1088,571&w=1200&h=630&fit=max&auto=format",
            "publishedAt": "2026-04-02T14:06:57Z",
            "lang": "en",
            "source": {
                "id": "30ed836e1ed3ae4068953ccc22a86df1",
                "name": "ایران اینترنشنال",
                "url": "https://www.iranintl.com"
            }
        },
        {
            "id": "5e5dff1aa65ae10a0ccc36ad7c39b251",
            "title": "Iran launches missile attacks as Trump claims war objectives nearly met",
            "description": "Iran has fired more missiles at Israel and Gulf Arab states, demonstrating Tehran’s continued ability to attack. That comes even as U.S.",
            "content": "DUBAI, United Arab Emirates (AP) — Iran fired more missiles at Israel and Gulf Arab states Thursday, demonstrating Tehran’s continued ability to strike its neighbors even as U.S. President Donald Trump claimed the threat from the country was nearly e... [5229 chars]",
            "url": "https://apnews.com/article/iran-us-israel-trump-lebanon-april-2-2026-c41dbdb8148d02ce6561ea6bd4aa0da1",
            "image": "https://dims.apnews.com/dims4/default/ea4a731/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fa3%2F03%2Fc1bdd02e16048276a77bc5e31273%2F29f12613ef4547f29fc89120985a9035",
            "publishedAt": "2026-04-02T12:58:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories