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": 239030,
    "articles": [
        {
            "id": "62c0bb3199ef270dc69408e5ff05bc5c",
            "title": "Embajadora Diana Salazar revela que hay acercamientos con Argentina para firmar un nuevo tratado de extradiciones",
            "description": "La funcionaria diplomática aborda los retos de su cambio de rol, el aporte de la comunidad ecuatoriana en ese país y los avances en cooperación bilateral.",
            "content": "Tras casi un año al frente de la misión diplomática en Buenos Aires, la exfiscal Diana Salazar Méndez hace un balance de su experiencia como embajadora de Ecuador en Argentina.\nEn una entrevista con EL UNIVERSO aborda los retos del cambio de rol, el ... [8242 chars]",
            "url": "https://www.eluniverso.com/noticias/politica/embajadora-diana-salazar-tiene-como-prioridad-incrementar-vuelos-entre-ecuador-y-argentina-nota/",
            "image": "https://www.eluniverso.com/resizer/v2/GGTSPBRFMVBIVPJRDEXXKFDAYE.jpg?auth=9d597a6d4e633c2c271aa71485e6a1216e90a36d9f9b0829c2d137b79a97c4f3&width=1005&height=670&quality=75&smart=true",
            "publishedAt": "2026-03-03T03:34:16Z",
            "lang": "es",
            "source": {
                "id": "fbe62a94a891b65106bff187fef25f02",
                "name": "El Universo",
                "url": "https://www.eluniverso.com"
            }
        },
        {
            "id": "6c8454119443603f26f197d2156c8506",
            "title": "La guerra con Irán está afectando rápidamente a la región",
            "description": "¿Hasta dónde podría llegar cada lado?",
            "content": "La guerra en Irán se extiende rápidamente. En las primeras 48 horas del conflicto, Estados Unidos e Israel han lanzado miles de bombas sobre Irán, las primeras de las cuales mataron al ayatollah Ali Khamenei, líder supremo del país. En respuesta, Irá... [6192 chars]",
            "url": "https://www.infobae.com/economist/2026/03/03/la-guerra-con-iran-esta-afectando-rapidamente-a-la-region/",
            "image": "https://www.infobae.com/resizer/v2/ZQDDE65R7RE4VDEUSBEEWWLIHY.jpg?auth=91b209c3ba9394f48be73e0ce8f13a62066fd6832e02f6d682825d3fe6aeddc5&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-03-03T03:15:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "6afe5c348313f7ef5c78aa1892e4fbe2",
            "title": "Israel-US war on Iran live: fire at US embassy in Riyadh after drone strike; state department urges all Americans to leave Middle East",
            "description": "Donald Trump says the war could go on for four-five weeks, adding US has ‘capability to go far longer’",
            "content": "Key events\nShow key events only\nPlease turn on JavaScript to use this feature\nUS attacked Iran 'pre-emptively' after learning Israel was going to launch strikes - Rubio\nThe US attacked Iran “pre-emptively” on Saturday to protect US forces from retali... [5240 chars]",
            "url": "https://www.theguardian.com/world/live/2026/mar/02/us-israel-war-iran-live-updates-attacks-strikes-tehran-lebanon-beirut-hezbollah-dubai-latest-news?page=with:block-69a5ea7f8f080cbafb2870ce",
            "image": "https://i.guim.co.uk/img/media/a6997cb148ad26fa89713796c02be8130606488b/927_0_4920_3936/master/4920.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=c7aee94b27bff40c2d1c3fa5a1ecd052",
            "publishedAt": "2026-03-03T01:53:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

Categories