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": 200194,
    "articles": [
        {
            "id": "363aaee5e8456269f024ea73abe1849c",
            "title": "The one world leader we’d most like to trade for Trump right now.",
            "description": "Slate’s guide to the most important figures in politics this week.",
            "content": "Sign up for the Surge, the newsletter that covers most important political nonsense of the week, delivered to your inbox every Saturday.\nWelcome to this week’s edition of the Surge, Slate’s weekly politics newsletter that needs to seriously ramp up i... [11400 chars]",
            "url": "https://slate.com/news-and-politics/2026/01/trump-versus-mark-carney-canada-prime-minister-ouch.html",
            "image": "https://compote.slate.com/images/a6222d55-a802-4df4-972b-881e28ffa85a.jpeg?crop=1560%2C1040%2Cx0%2Cy0&width=1560",
            "publishedAt": "2026-01-24T10:45:00Z",
            "lang": "en",
            "source": {
                "id": "c8e1cfcb970c5e9a0a496c6b603e74b2",
                "name": "Slate",
                "url": "https://slate.com"
            }
        },
        {
            "id": "eccb6ae110a45316e2c9541eee77a29e",
            "title": "El régimen chino abrió una investigación contra el general de más alto rango de Xi Jinping",
            "description": "Se trata de Zhang Youxia, quien ocupa el segundo puesto en la Comisión Militar Central, justo por debajo del líder",
            "content": "El Ministerio de Defensa Nacional del régimen de China informó sobre la apertura de una investigación contra el general de mayor rango del país, Zhang Youxia, quien ocupa el segundo puesto en la Comisión Militar Central (CMC), justo por debajo del pr... [2091 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/01/24/el-regimen-chino-abrio-una-investigacion-contra-su-general-de-mas-alto-rango-y-numero-2-militar-de-xi-jinping/",
            "image": "https://www.infobae.com/resizer/v2/DDQFMDXK3GI27EXAQGVVKTD57A.jpg?auth=a4ae0d8a71f4a30e60ad723a6488caaeceed39c74a516d4a5c9333b216ffe923&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-01-24T10:13:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "021e1a6e3f62a1a4a97d123f9285668d",
            "title": "How a Year of Trump Changed Britain",
            "description": "Prime Minister Keir Starmer stood firm over Greenland. But his center-left government and the country as a whole have been buffeted by President Trump.",
            "content": "Britain has learned, after a roller coaster year that ended in a tense confrontation over Greenland, that it cannot change President Trump. The more tantalizing question is whether Mr. Trump has changed Britain.\nPrime Minister Keir Starmer’s charm of... [960 chars]",
            "url": "https://www.nytimes.com/2026/01/24/world/europe/trump-uk-changes.html",
            "image": "https://static01.nyt.com/images/2026/01/24/multimedia/24int-uk-trump-01-mfcp/24int-uk-trump-01-mfcp-facebookJumbo.jpg",
            "publishedAt": "2026-01-24T10:01:52Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories