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": 243588,
    "articles": [
        {
            "id": "5d689045a8c09d50a0fc44d4f5fadae3",
            "title": "Qatar says Iran attack caused significant damage at Ras Laffan gas facility",
            "description": "Qatar declares the Iranian embassy’s military and security attaches as persona non grata after Ras Laffan attack.",
            "content": "Qatar has said Iranian missile attacks on the Ras Laffan Industrial City, the country’s main gas facility, have caused “significant damage”.\n“The State of Qatar expresses its strong condemnation and denunciation of the blatant Iranian attack targetin... [5122 chars]",
            "url": "https://www.aljazeera.com/news/2026/3/18/qatar-says-iran-missile-attack-sparks-fire-causes-damage-at-gas-facility",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/03/reuters_69a96987-1772710279.jpg?resize=1920%2C1440",
            "publishedAt": "2026-03-19T02:26:15Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "a0f9b6b5e0ea39b98fca2aa3d1450fbe",
            "title": "Oil prices spiral even as President Trump suspends Jones Act",
            "description": "Oil prices increased Wednesday despite President Donald Trump’s suspension of the Jones Act, which regulates shipping. Unleaded gas costs 32 percent more than a month ago.",
            "content": "President Donald Trump’s suspension of the Jones Act to free up shipping did little to calm markets. The average cost of unleaded gas is now 32 percent higher than a month ago.\nUpdated\nMarch 18, 2026 at 6:33 p.m. EDTyesterday at 6:33 p.m. EDT\nOil pri... [465 chars]",
            "url": "https://www.washingtonpost.com/business/2026/03/18/oil-jones-act-trump-iran/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/A6H45G6AORQHFGROSC2QJOVZB4_size-normalized.jpg&w=1440",
            "publishedAt": "2026-03-19T00:16:54Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "61468b3fa2fa8556ee12ac9bda213f27",
            "title": "Un buque ruso cargado de combustible navega hacia Cuba pese al bloqueo de Estados Unidos",
            "description": "Está previsto que el Sea Horse, con bandera de Hong Kong, llegue en cinco días. Transporta 200.000 barriles de diésel, suficientes para 10 días",
            "content": "Rusia ha decidido desafiar el bloqueo petrolero de Washington a Cuba. Moscú ha enviado a la isla, que no ha recibido una sola gota de combustible desde enero, un buque con hasta 200.000 barriles de diésel, según ha podido confirmar este miércoles EL ... [4331 chars]",
            "url": "https://elpais.com/us/2026-03-18/un-buque-ruso-cargado-de-combustible-navega-hacia-cuba-pese-al-bloqueo-de-estados-unidos.html",
            "image": "https://imagenes.elpais.com/resizer/v2/IMVLYHRNPBBDHI63YZZLMREDHA.JPG?auth=c960d05b585dc354a63327bde66b980fd3103a234727e583e5c49dc6b3985401&width=1200",
            "publishedAt": "2026-03-18T22:51:00Z",
            "lang": "es",
            "source": {
                "id": "eb1bfc7349a10fd1bd06d9ecfaa8b438",
                "name": "EL PAÍS",
                "url": "https://elpais.com"
            }
        }
    ]
}

Categories