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": 207752,
    "articles": [
        {
            "id": "c8deaaeafd138a554f4adc4b14c1e3e7",
            "title": "Helmeted dog on bike in Mexico City : NPR",
            "description": "Every week, more than 100,000 people ride bikes, skates and rollerblades past some of the best-known parts of Mexico's capital. And sometimes their dogs join them too.",
            "content": "Far-Flung Postcards is a weekly series in which NPR's international team shares moments from their lives and work around the world.\nEvery Sunday, Mexico City shuts down the Paseo de la Reforma, the most important street in the country, to car traffic... [716 chars]",
            "url": "https://www.npr.org/2026/02/11/nx-s1-5699414/mexico-city-sunday-paseo-de-la-reforma",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/1920x1080+0+0/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F11%2Fd4%2F68683a454de89206a5868b2daf61%2Ffarflungpostcard-ep.jpg",
            "publishedAt": "2026-02-11T13:39:58Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "32cac66aa022039e52647134d7d20a02",
            "title": "Tras la amenaza de Rusia, la OTAN lanzó la misión Centinela del Ártico para reforzar su presencia militar en Groenlandia",
            "description": "El inicio de una operación coordinada entre países aliados incrementa la vigilancia y el despliegue de tropas en la región, en respuesta al aumento de tensiones por el interés estratégico internacional. El canciller ruso dijo que Moscú podría reaccionar con medidas similares",
            "content": "La OTAN inició la misión Centinela del Ártico para reforzar su presencia militar en la región, tras alcanzar un acuerdo orientado a reducir la tensión interna surgida por el interés del presidente estadounidense Donald Trump en adquirir Groenlandia. ... [3285 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/02/11/tras-la-amenaza-de-rusia-la-otan-lanzo-la-mision-centinela-del-artico-para-reforzar-su-presencia-militar-en-groenlandia/",
            "image": "https://www.infobae.com/resizer/v2/WUJDVQBEJBCEBEXOC3OO3Q5RKY.JPG?auth=3014d2641e89435b7c1a5340d06c1d94e28f1f6be117e954bebee6d15a99cd66&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-02-11T13:39:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "61298562b8b6d37fbd9e24faffe6bbb6",
            "title": "Male refugees stigmatised across Europe: ‘This kind of stuff really hurts’",
            "description": "Several men who made dangerous journeys alone tell Al Jazeera they have faced suspicion, hatred and homelessness.",
            "content": "Names marked with an asterisk have been changed to protect identities.\nAthens, Greece – Ahmed* was 14 and alone when he first arrived in Germany in 2019 from Afghanistan. He had only the clothes on his back and a phone.\nRecommended Stories\nlist of 4 ... [8571 chars]",
            "url": "https://www.aljazeera.com/news/2026/2/11/male-refugees-stigmatised-europe",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/02/2025-12-12T152219Z_694959238_RC2YEIAA8TEG_RTRMADP_3_MIGRATION-EUROPE-MALTA-1770809045.jpg?resize=1920%2C1440",
            "publishedAt": "2026-02-11T12:41:10Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        }
    ]
}

Categories