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": 508666,
    "articles": [
        {
            "id": "44efc22a88e1a3cfa9c6eef46b08ac38",
            "title": "Six injured in Washington state school stabbing",
            "description": "Five students and one security guard were taken to hospital following the attack at Foss High School.",
            "content": "Six people have been injured in a stabbing at a school in the US state of Washington following an \"altercation\", police said.\nFive high school students and an adult security guard were taken to hospital on Thursday, Tacoma Fire Department confirmed, ... [1204 chars]",
            "url": "https://www.bbc.com/news/articles/cewp2ll1zljo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/3d6c/live/7799e9e0-4528-11f1-bd52-e755d604ece4.jpg",
            "publishedAt": "2026-05-01T07:12:23Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "6d6f52224fa956a88fc84f80ca16646f",
            "title": "Banksy confirms a new statue in central London of a man blinded by a flag is his work",
            "description": "Elusive street artist Banksy has claimed responsibility for a new sculpture in central London",
            "content": "LONDON -- Elusive street artist Banksy said Thursday that a new sculpture that appeared in central London of a man striding off a plinth, with his face blinded by a billowing flag, is his work.\nIn a humorous video posted Thursday on his Instagram acc... [1153 chars]",
            "url": "https://abcnews.com/International/wireStory/banksy-confirms-new-statue-central-london-man-blinded-132537622",
            "image": "https://i.abcnewsfe.com/a/c87ec4a1-0c3a-4656-9d20-38928b78bbaa/wirestory_a9094fcb5836e9c066eda36f33cb7395_16x9.jpg?w=1600",
            "publishedAt": "2026-05-01T07:11:45Z",
            "lang": "en",
            "source": {
                "id": "d35e5701ba890c345f47dc0dd5522375",
                "name": "ABC News - Breaking News, Latest News and Videos",
                "url": "https://abcnews.com"
            }
        },
        {
            "id": "5667504f8917f0a9f300c92d041d8e0c",
            "title": "Violence Erupts in Australian Town After Arrest of Suspect in Girl’s Killing",
            "description": "Police in Alice Springs fired rubber bullets and tear gas to disperse an angry crowd demanding justice.",
            "content": "Violence erupted across a rural town in northern Australia on Thursday night, after a crowd of people assaulted a man suspected of killing a five-year-old Indigenous girl and then clashed with the police officers who were arresting him.\nOfficers tran... [1324 chars]",
            "url": "https://www.nytimes.com/2026/05/01/world/australia/alice-springs-jefferson-lewis-girl-kumanjayi.html",
            "image": "https://static01.nyt.com/images/2026/05/01/multimedia/01int-Oz-crime-ltkp/01int-Oz-crime-ltkp-facebookJumbo.jpg",
            "publishedAt": "2026-05-01T06:28:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories