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": 554136,
    "articles": [
        {
            "id": "6c19bfebe3a4b58e79ac3bdd75a2bc60",
            "title": "Mixed messaging from Iran and US on ceasefire deal",
            "description": "Iranian state media reported that Iran was halting indirect talks with the US after Israel ordered its troops to push deeper into Lebanon. US President Donald Trump said talks were ongoing at a \"rapid pace.\"",
            "content": "Live\nConflictsMiddle East\nMixed messaging from Iran and US on ceasefire deal\nMark Hallam | Timothy Jones Reuters, AFP, AP, dpa\nPublished 06/01/2026Published June 1, 2026\nIranian state media reported that Iran was halting indirect talks with the US af... [19984 chars]",
            "url": "https://www.dw.com/en/mixed-messaging-from-iran-and-us-on-ceasefire-deal/live-77369317",
            "image": "https://static.dw.com/image/77374783_6.jpg",
            "publishedAt": "2026-06-01T22:41:15Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "e44ba78ffb4f7b07e94c2ee0c910a524",
            "title": "Ken answers your questions about the meteor",
            "description": "The meteor was around five feet wide, had a mass of 5.6 metric tons (the weight of a fully grown elephant), NASA said.",
            "content": "NASA has also shared that the meteor traveled through the atmosphere from the northwest to southeast for 26 miles before breaking up at an altitude of 31 miles and producing a meteorite fall into the Cape Cod Bay.\nThe energy released was staggering, ... [8281 chars]",
            "url": "https://www.bostonglobe.com/2026/06/01/metro/boston-meteor-new-england-weather/",
            "image": "https://bostonglobe-prod.cdn.arcpublishing.com/resizer/v2/M7ZMVV5PERBTDK2ZL7VEAHTWMM.gif?auth=f295a6dda88b71a6164ad21298d6777f9bd5ba459d353f5fc3cd0433dacea22b&width=1440",
            "publishedAt": "2026-06-01T22:12:29Z",
            "lang": "en",
            "source": {
                "id": "4f5ad96a550eaec82f7b44d0fa63d19e",
                "name": "The Boston Globe",
                "url": "https://www.bostonglobe.com"
            }
        },
        {
            "id": "98e766e739201139a4804769afa904cd",
            "title": "Bus driver in Stafford Co. crash indicted on charges tied to all 5 deaths",
            "description": "The bus driver in Friday’s deadly chain-reaction crash on Interstate 95 in Stafford County, Virginia, has now been indicted on five counts of involuntary manslaughter",
            "content": "The bus driver in Friday’s deadly chain-reaction crash on Interstate 95 in Stafford County, Virginia, has now been indicted on five counts of involuntary manslaughter — one for each death resulting from the crash.\nA grand jury in Stafford County Circ... [2515 chars]",
            "url": "https://wtop.com/stafford-county/2026/06/bus-driver-in-stafford-co-crash-indicted-on-charges-tied-to-all-5-deaths/",
            "image": "https://wtop.com/wp-content/uploads/2026/05/stafford-bus-crash.jpg",
            "publishedAt": "2026-06-01T22:04:52Z",
            "lang": "en",
            "source": {
                "id": "be56a24e3eb718f62ca69f2fcc5fe66d",
                "name": "WTOP",
                "url": "https://wtop.com"
            }
        }
    ]
}

Categories