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": 484788,
    "articles": [
        {
            "id": "e609953ed970017e3772e6608a5a65be",
            "title": "What a GOP loss in Trump’s Mar-a-Lago district says about the midterms",
            "description": "Including off-year elections last year, Democrats have flipped 30 Republican seats since the start of 2025.",
            "content": "Democrat Emily Gregory knew her upset victory on Tuesday night in Florida was a big deal when her third-grader told her, “Mom, you really surprised me.”\nGregory, a first-time candidate and fitness business owner, defeated Jon Maples, a Republican end... [458 chars]",
            "url": "https://www.washingtonpost.com/politics/2026/03/25/democrats-midterms-special-election-wins/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/UOBPG3JBDS6YOCWRFMFBBKUNPE_size-normalized.JPG&w=1440",
            "publishedAt": "2026-03-25T23:29:54Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "bd5d47639c21f7bffb75761b7bdc56ad",
            "title": "Yailin podría pasar varios años en prisión: ella estaría “llorando” y muy “afectada”",
            "description": "La cantante Yailin La Más Viral no la estaría pasando nada bien en el Centro Penitenciario de San Luis luego de ser arrestada por presunta portación ilegal de armas durante un operativo. | Univision Famosos | Univision",
            "content": "VixNoticiasShowsFamososDeportesRadioShop\nYailin la Mas Viral\nYailin podría pasar varios años en prisión: ella estaría “llorando” y muy “afectada”\nLa cantante no la estaría pasando nada bien en el Centro Penitenciario de San Luis luego de ser arrestad... [7105 chars]",
            "url": "https://www.univision.com/famosos/yailin-prision-anos-estaria-llorando-afectada",
            "image": "https://www.univision.com/api/image/og/us/famosos/yailin-prision-anos-estaria-llorando-afectada",
            "publishedAt": "2026-03-25T23:25:25Z",
            "lang": "es",
            "source": {
                "id": "eb4456d007d51d44dc62d01c16a53d83",
                "name": "Univision",
                "url": "https://www.univision.com"
            }
        },
        {
            "id": "eb49abedc7859ec112d71d1e51a0a196",
            "title": "Instagram and YouTube found liable in landmark social media addiction trial",
            "description": "A jury has found Meta and YouTube liable in a first-of-its-kind lawsuit that aimed to hold social media platforms responsible for harm to children using their services.",
            "content": "LOS ANGELES (AP) — Meta and YouTube must pay millions in damages to a 20-year-old woman after a jury decided the social media giant and video streamer designed their platforms to hook young users without concern for their well being.\nThe California j... [6803 chars]",
            "url": "https://apnews.com/article/social-media-addiction-trial-la-5e54075023d837ccdc76c4ca512e925d",
            "image": "https://dims.apnews.com/dims4/default/f177639/2147483647/strip/true/crop/7954x5300+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc8%2Fc7%2F0e7a92e752309f66e08331bfe0f1%2Fceb0532db9f14482a2b407b67b70c667",
            "publishedAt": "2026-03-25T23:16:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories