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": 561034,
    "articles": [
        {
            "id": "a35c751242a7aa9edf414631abf5ea01",
            "title": "2026 NBA Draft grades: Live pick-by-pick analysis",
            "description": "Adam Finkelstein has the breakdown of each pick in one of the best drafts in recent memory",
            "content": "The 2026 NBA Draft is one that scouts and executives have targeted for several years now. Loaded at the very top with a Big 3 whose potential stardom has been well-documented since high school - AJ Dybantsa, Darryn Peterson, and Cameron Boozer could ... [12998 chars]",
            "url": "https://www.cbssports.com/nba/news/2026-nba-draft-grades-live-pick-by-pick-analysis-updates-round-1/",
            "image": "https://sportshub.cbsistatic.com/i/r/2026/06/24/2306523e-8be1-4638-b1f7-241c55b429d1/thumbnail/1200x675/4a690d97ad93a99581b542d403bf8694/dybantsa-goes-no-1-getty.jpg",
            "publishedAt": "2026-06-24T01:33:00Z",
            "lang": "en",
            "source": {
                "id": "416e66c8ea979965c0cee3b0ed1f714b",
                "name": "CBS Sports",
                "url": "https://www.cbssports.com"
            }
        },
        {
            "id": "86e0b1766f587eccfa3a25f52acc74a2",
            "title": "Chinese supercomputer leapfrogs best US machines to be ranked world’s fastest",
            "description": "China’s LineShine debuts at number one in Top500 – a list sometimes viewed as a national measure of global tech prowess",
            "content": "A supercomputer in China now outranks its US counterparts as the world’s most powerful. It is the first time since 2017 that a Chinese computer has topped a list sometimes viewed as a measure of a nation’s technological prowess.\nThe LineShine compute... [2548 chars]",
            "url": "https://www.theguardian.com/technology/2026/jun/24/china-supercomputer-world-fastest-top500-ranking-lineshine",
            "image": "https://i.guim.co.uk/img/media/789fcb3f16ff69cb8d10257eafbb58ed1ea4c42a/727_0_4888_3911/master/4888.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=9ad51712e838442477399f662c65cc09",
            "publishedAt": "2026-06-24T01:19:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "6286235a1529a17bc142a922ae38b403",
            "title": "Diferencias entre preconteo y escrutinio de las últimas cuatro segundas vueltas no superó 0,23 puntos porcentuales: esto dicen los datos",
            "description": "Desde 2010, ningún resultado presidencial se ha revertido tras el conteo oficial y las distancias han sido mínimas.",
            "content": "En las segundas vueltas presidenciales realizadas en Colombia entre 2010 y 2022, la diferencia entre el preconteo —los resultados preliminares de la noche electoral— y el escrutinio oficial nunca superó 0,23 puntos porcentuales.\nAsí lo comprobó una r... [4141 chars]",
            "url": "https://www.eltiempo.com/politica/elecciones-colombia-2026/diferencias-entre-preconteo-y-escrutinio-de-las-ultimas-cuatro-segundas-vueltas-no-supero-0-23-puntos-porcentuales-esto-dicen-los-datos-3566547",
            "image": "https://imagenes2.eltiempo.com/files/og_thumbnail/files/fp/uploads/2026/06/22/6a3924e4602e3.r_d.587-272-0.png",
            "publishedAt": "2026-06-24T00:28:34Z",
            "lang": "es",
            "source": {
                "id": "58dd8560c9b69789426e2f65cf9472fd",
                "name": "ELTIEMPO.com",
                "url": "https://www.eltiempo.com"
            }
        }
    ]
}

Categories