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": 233934,
    "articles": [
        {
            "id": "23351a43122955812347f77729a65ecc",
            "title": "Grief and rage in Lebanon ahead of talks with Israel in the US",
            "description": "Mourners in Lebanon are burying 13 state security officers killed when Israeli airstrikes hit their office headquarters in the southern Lebanese town of Nabatiyeh.",
            "content": "SIDON, Lebanon (AP) — Women in black screamed in grief and toddlers sobbed uncontrollably, calling out for their dead fathers and uncles. Men in uniforms, pistols strapped to their belts, wept openly for their comrades at the funerals on Saturday for... [6240 chars]",
            "url": "https://apnews.com/article/lebanon-israel-war-hezbollah-negotiations-394f8bdaee36bab82ab3ebc713221302",
            "image": "https://dims.apnews.com/dims4/default/2e00991/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F41%2F49%2Fcfd26e901f88f3653a6273fab4de%2Fd555a27e137c429ebb484168c8ec5e12",
            "publishedAt": "2026-04-11T21:41:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "2f1ffa51693779e2cbb551bbbc7af510",
            "title": "Man arrested after allegedly damaging US military aircraft at Shannon Airport",
            "description": "Airport operations briefly halted after man entered restricted area, climbed aircraft and allegedly caused damage before being detained.",
            "content": "It is understood the individual climbed onto the wing of the aircraft and caused damage to the fuselage with an implement, possibly an axe.\nMobile stairs were used to reach and detain the man.\nAirport Police officers and Shannon Airport’s fire and re... [2009 chars]",
            "url": "https://www.irishexaminer.com/news/munster/arid-41825639.html",
            "image": "https://www.irishexaminer.com/cms_media/module_img/10074/5037062_6_seoimageog_335789_1_.jpg",
            "publishedAt": "2026-04-11T20:17:00Z",
            "lang": "en",
            "source": {
                "id": "634dc62a3fe9c48f4c2cc004e680a220",
                "name": "Irish Examiner",
                "url": "https://www.irishexaminer.com"
            }
        },
        {
            "id": "7e2f4d190b898263ef3565f5d4c343b9",
            "title": "Irish police clear demonstrators to reopen refinery as fuel protest causes chaos",
            "description": "Police removed and arrested protesters on Saturday to reopen Ireland 's only oil refinery as a fifth day of disruptive demonstrations over the soaring price of fuel left many gas pumps dry and threatened to cripple transportation across the country.",
            "content": "DUBLIN — Police removed and arrested protesters on Saturday to reopen Ireland 's only oil refinery as a fifth day of disruptive demonstrations over the soaring price of fuel left many gas pumps dry and threatened to cripple transportation across the ... [4332 chars]",
            "url": "https://www.nbcnews.com/world/ireland/ireland-fuel-protests-rcna301014",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-04/260411-dublin-refinery-protest-ch-1309-585b85.jpg",
            "publishedAt": "2026-04-11T19:23:34Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        }
    ]
}

Categories