United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 511142,
    "articles": [
        {
            "id": "4ccf63741b59ce7e5157288a76492aed",
            "title": "Two people stabbed in north London, Jewish security group says, after spate of recent attacks",
            "description": "Two people have been stabbed in Golders Green, north London, according to a local Jewish neighborhood watch group.",
            "content": "Two people have been stabbed in Golders Green, north London, according to a local Jewish neighborhood watch group, amid a series of antisemitic attacks targeting London’s Jewish community.\nA man has been detained, according to a CNN team on the groun... [1055 chars]",
            "url": "https://www.cnn.com/2026/04/29/uk/north-london-stabbing-jewish-community-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/still-22581677-1500-still.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-04-29T11:15:14Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "6958c226192b9f65d3db61c57d92f678",
            "title": "‘Suicidal’ model of capitalism leading to war and fascism, climate summit told",
            "description": "Colombia president Gustavo Petro tells 57-country talks on a green energy transition that fossil fuel interests could destroy humanity",
            "content": "The world is threatened by a “suicidal” model of capitalism that is leading to war, fascism and the potential extinction of humanity, Colombia’s president has said, as he convened 57 governments to address the climate crisis.\nGustavo Petro blamed fos... [5236 chars]",
            "url": "https://www.theguardian.com/environment/2026/apr/29/capitalism-colombia-climate-summit-gustavo-petro",
            "image": "https://i.guim.co.uk/img/media/c7cd18595ca7dc62b2117415d8d3b69f17843abf/518_312_3594_2875/master/3594.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=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=62d4d1c9032321c87b1e488fe879549a",
            "publishedAt": "2026-04-29T10:46:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "de9da688f522f0daf65384c31ca500aa",
            "title": "White House, Dems point fingers on political rhetoric after shooting",
            "description": "The White House says a shooting at a press gala Trump attended is the 'predictable result' of Democratic rhetoric, prompting pushback from Democrats.",
            "content": "On the night an alleged assassination attempt against President Donald Trump was foiled after a burst of gunfire at a press gala, the president took the podium in the White House briefing room afterward and talked about unity.\n“This was an event dedi... [6519 chars]",
            "url": "https://www.usatoday.com/story/news/politics/2026/04/29/donald-trump-democrats-political-rhetoric-shooting-whca-dinner/89840659007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/04/28/USAT/89842658007-leavitt-pic.JPG?crop=3066,1726,x0,y159&width=3066&height=1726&format=pjpg&auto=webp",
            "publishedAt": "2026-04-29T09:23:00Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        }
    ]
}

Categories