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": 379236,
    "articles": [
        {
            "id": "f175c5323abc611cb22de5b890334057",
            "title": "Sede, horario y dónde verlo por TV",
            "description": "El encuentro se realizó en el estadio Morazán de la ciudad de San Pedro Sula.",
            "content": "MINUTO A MINUTO DEL JUEGO REAL ESPAÑA VS OLANCHO FC\nMINUTO 90+4: Finaliza el encuentro y Real España se lleva el triunfo con marcador de 2-0 sobre Olancho FC y logra sus primeros tres puntos del torneo Clausura.\nMINUTO 90: Cuatro minutos de descuento... [4824 chars]",
            "url": "https://www.diez.hn/liganacionaldehonduras/real-espana-olancho-estreno-ambos-torneo-clausura-sede-horario-honduras-NP29048522",
            "image": "https://www.diez.hn/binrepository/1201x989/0c0/1200d630/none/3014757/QJDL/david-sayago-real-espana_13324474_20260124212337.jpg",
            "publishedAt": "2026-01-25T02:52:44Z",
            "lang": "es",
            "source": {
                "id": "62687b88e66412a58e4dbdec538ec187",
                "name": "DIEZ.HN",
                "url": "https://www.diez.hn"
            }
        },
        {
            "id": "41de5f3791861ab484d432daa607236a",
            "title": "Rhodes, Fatu didn’t actually have match at Saturday Night’s Main Event, and it was awesome",
            "description": "WWE did not deliver on what they advertised here but I don’t care because it was still awesome.",
            "content": "I was curious how WWE would handle the Cody Rhodes vs. Jacob Fatu match at tonight’s (Jan. 24, 2026) Saturday Night’s Main Event special at the Bell Centre in Montreal, Quebec, Canada. Fatu, after all, is rumored to be in for a big push as we head in... [826 chars]",
            "url": "https://www.cagesideseats.com/wwe/413141/cody-rhodes-and-jacob-fatu-didnt-actually-have-a-match-at-saturday-nights-main-event-and-it-was-awesome",
            "image": "https://platform.cagesideseats.com/wp-content/uploads/sites/54/2026/01/CRDM.png?quality=90&strip=all&crop=0%2C3.4075003269224%2C100%2C93.184999346155&w=1200",
            "publishedAt": "2026-01-25T01:26:48Z",
            "lang": "en",
            "source": {
                "id": "f0c93ff323489e08f99094e7cf89daf8",
                "name": "Cageside Seats",
                "url": "https://www.cagesideseats.com"
            }
        },
        {
            "id": "089b011335758c31b85b7606944943e7",
            "title": "Democrats Vow Not to Fund ICE After Shooting, Imperiling Spending Deal",
            "description": "Key Senate Democrats said they would oppose legislation needed to avoid a government shutdown at the end of the week after federal agents shot and killed a Minneapolis resident.",
            "content": "Bipartisan legislation to fund a broad swath of the government and avert a shutdown at the end of the week appeared to be in grave danger on Saturday, as key Senate Democrats vowed to oppose it after federal agents shot and killed a Minneapolis resid... [2144 chars]",
            "url": "https://www.nytimes.com/2026/01/24/us/democrats-congress-reaction.html",
            "image": "https://static01.nyt.com/images/2026/01/13/multimedia/24minneapolis-ice-congress/13TRUMP-NEWS-WARNER-print-lpkc-facebookJumbo.jpg",
            "publishedAt": "2026-01-25T01:03:36Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories