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": 245792,
    "articles": [
        {
            "id": "bab85358e66e9df13bb3f383f1fed34b",
            "title": "Top intelligence official Amaryllis Fox Kennedy, a Gabbard ally, resigns",
            "description": "Top intelligence official Amaryllis Fox Kennedy, a daughter-in-law of RFK Jr., is leaving top posts at the Office of the Director of National Intelligence and the Office of Management and Budget.",
            "content": "The daughter-in-law of RFK Jr. held top posts at the Office of the Director of National Intelligence and the Office of Management and Budget.\nMay 19, 2026 at 6:15 p.m. EDTYesterday at 6:15 p.m. EDT\nAmaryllis Fox Kennedy, a top Trump administration in... [454 chars]",
            "url": "https://www.washingtonpost.com/national-security/2026/05/19/top-intelligence-official-amaryllis-fox-kennedy-gabbard-ally-resigns/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/RZ7SKGQFE5EW3FD4XNPTG325MU.jpg&w=1440",
            "publishedAt": "2026-05-20T01:25:22Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "93484ce2f07c92fa913a78443a51ff87",
            "title": "Gobierno de Estados Unidos denuncia intento de golpe de Estado en país latinoamericano",
            "description": "Según el Departamento de Estado, se trata de “‘un ‘golpe’ financiado por esa alianza entre política y crimen organizado en toda la región”.",
            "content": "Bolivia se enfrenta a un intento de “golpe de Estado”, declaró este martes el subsecretario de Estado, Christopher Landau, ante las masivas protestas que buscan la renuncia del presidente centroderechista Rodrigo Paz, promulgadas por simpatizantes de... [2502 chars]",
            "url": "https://www.semana.com/mundo/articulo/gobierno-de-estados-unidos-denuncia-intento-de-golpe-de-estado-en-pais-latinoamericano/202635/",
            "image": "https://www.semana.com/resizer/v2/BOKX5KPLO5HN7KDBL2SY3GZHAM.jpg?auth=658f2e142ccb52c8657239a37200a74f6786ff97a06d367330eb272752087169&smart=true&quality=75&width=1280&height=720",
            "publishedAt": "2026-05-20T00:07:20Z",
            "lang": "es",
            "source": {
                "id": "9c364a5dd1f4ed8e5ff09e7f1d30dc3d",
                "name": "Revista Semana",
                "url": "https://www.semana.com"
            }
        },
        {
            "id": "596571433b29134be67f2ebd7d828622",
            "title": "Early War Goal Was to Install Hard Line Former President as Iran’s Leader",
            "description": "An Israeli strike designed to free Mahmoud Ahmadinejad from house arrest in Tehran, U.S. officials said, was part of an effort to bring about regime change and put him in power.",
            "content": "Days after Israeli strikes killed Iran’s supreme leader and other top officials in the opening salvos of the war, President Trump mused publicly that it would be best if “someone from within” Iran took over the country.\nIt turns out that the United S... [1445 chars]",
            "url": "https://www.nytimes.com/2026/05/19/us/politics/iran-israel-us-leader-ahmadinejad.html",
            "image": "https://static01.nyt.com/images/2026/05/19/multimedia/19dc-iran-ahmadinejad-top-hfjq/19dc-iran-ahmadinejad-top-hfjq-facebookJumbo.jpg",
            "publishedAt": "2026-05-19T23:33:54Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories