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": 238738,
    "articles": [
        {
            "id": "44fbfcea05cc6410facd29c60490bbf3",
            "title": "Gunman shoots several tourists at historic pyramids in Mexico",
            "description": "A man standing atop one of the historic Teotihuacan pyramids opened fire on tourists Monday, killing one Canadian and leaving at least 13 people, authorities said.",
            "content": "MEXICO CITY — An armed man standing atop one of the historic Teotihuacan pyramids opened fire on tourists Monday, killing one Canadian and leaving at least 13 people injured at the archaeological site north of Mexico's capital, authorities said.\nThe ... [3856 chars]",
            "url": "https://www.npr.org/2026/04/21/g-s1-118185/gunman-pyramids-mexico",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/2175x1223+0+113/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2Fab%2Fab%2Fed8706a742efbd31ad2e338ee19a%2Fap26110785005303.jpg",
            "publishedAt": "2026-04-21T05:18:53Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "c1032e6736de616a9672fa2420e84edb",
            "title": "Tiroteo en Teotihuacán: lo que sabemos",
            "description": "El hombre armado abrió fuego en el yacimiento arqueológico de Teotihuacán, a las afueras de Ciudad de México, antes de quitarse la vida. Entre los heridos había seis estadounidenses.",
            "content": "Una turista canadiense murió en una balacera y varias personas resultaron heridas, incluidas estadounidenses, dijeron las autoridades, cuando un hombre abrió fuego el lunes en uno de los destinos turísticos más populares de México: las pirámides de T... [1014 chars]",
            "url": "https://www.nytimes.com/es/2026/04/20/espanol/america-latina/teotihuacan-tiroteo-balacera-mexico.html",
            "image": "https://static01.nyt.com/images/2026/04/20/espanol/20int-mexico-shooting-tckv-ES-copy1/20int-mexico-shooting-tckv-facebookJumbo.jpg",
            "publishedAt": "2026-04-21T03:53:49Z",
            "lang": "es",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "d8f873f875ce9e261cce2672a5fa967a",
            "title": "Canadian Tourist Is Killed in Shooting at Mexico’s Pyramids",
            "description": "A gunman opened fire at the Teotihuacán archaeological site outside Mexico City before killing himself, the authorities said. Six Americans were among those injured, including two from gunshots.",
            "content": "One Canadian tourist was shot dead and several other people were wounded, including U.S. nationals, officials said, when a man opened fire on Monday at one of Mexico’s most popular tourist destinations, the Teotihuacán pyramids just outside Mexico Ci... [836 chars]",
            "url": "https://www.nytimes.com/2026/04/20/world/americas/mexico-shooting-pyramids-teotihuacan.html",
            "image": "https://static01.nyt.com/images/2026/04/20/multimedia/20int-mexico-shooting-tckv/20int-mexico-shooting-tckv-facebookJumbo.jpg",
            "publishedAt": "2026-04-21T02:25:49Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories