Flag of United States

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": 7219906,
    "articles": [
        {
            "id": "06fc4db54a68aa1e73e6058505a3eb19",
            "title": "Trump says he's sending the National Guard into Memphis to 'fix' crime like D.C.",
            "description": "President Donald Trump said Friday that he's planning to send federal law enforcement and the National Guard into Memphis, Tennessee, to lower crime in the city following his surge into Washington, D.C., over the last month.",
            "content": "President Donald Trump said Friday that he's planning to send federal law enforcement and the National Guard into Memphis, Tennessee, to lower crime in the city following his surge into Washington, D.C., over the last month.\n\"We’re going to Memphis. ... [2265 chars]",
            "url": "https://www.nbcnews.com/politics/white-house/trump-says-sending-national-guard-memphis-fix-crime-dc-rcna230784",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-09/250912-memphis-skyline-mn-0840-d783b9.jpg",
            "publishedAt": "2025-09-12T13:33:06Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com",
                "country": "us"
            }
        },
        {
            "id": "1986aa2b4f3d881413c127f2f8ff6448",
            "title": "Prince Harry makes surprise visit to Ukraine in support of wounded service members",
            "description": "Prince Harry has arrived in Ukraine for a surprise visit to support wounded service members",
            "content": "LONDON -- Britain’s Prince Harry arrived in Ukraine on Friday for a surprise visit in support of wounded service members.\nIt’s the second time that Harry has visited the country, which is among the nations bidding to host the Invictus Games in four y... [633 chars]",
            "url": "https://abcnews.go.com/International/wireStory/prince-harry-makes-surprise-visit-ukraine-support-wounded-125502869",
            "image": "https://i.abcnewsfe.com/a/a4244f9a-0b98-45e7-bfc9-6b5de4875671/wirestory_7bd712c94881633095660599b3bdefe8_16x9.jpg?w=1600",
            "publishedAt": "2025-09-12T13:24:32Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "ABC News",
                "url": "https://abcnews.go.com",
                "country": "us"
            }
        },
        {
            "id": "3d8a67e46d1ee73c0752c3e5e5aaf37e",
            "title": "Shaun White and Nina Dobrev call off their engagement",
            "description": "Shaun White and Nina Dobrev have called off their engagement and brought an end to their five-year relationship, a person close to the couple tells The Associated Press.",
            "content": "Shaun White and Nina Dobrev have called off their engagement and brought an end to their five-year relationship, a person close to the couple told The Associated Press.\nThe three-time Olympic champion snowboarder and the former star of “The Vampire D... [1749 chars]",
            "url": "https://apnews.com/article/shaun-white-nina-dobrev-breakup-4884830fc42104b1b8b31f731f65f187",
            "image": "https://dims.apnews.com/dims4/default/fe72e8f/2147483647/strip/true/crop/5999x3374+0+312/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fcf%2Fec%2Fb1e8135ad2b86c5881b08e9c9bc2%2F5a065c50b3ce492d849145d8b807f9fe",
            "publishedAt": "2025-09-12T13:18:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com",
                "country": "us"
            }
        }
    ]
}

Categories