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": 368650,
    "articles": [
        {
            "id": "4e71d4e8a9607c3932db70f5bc88c8a4",
            "title": "Live Updates: Trains Collide After Derailment in Spain, Killing at Least 21",
            "description": "A high-speed train smashed into another train after derailing in the southern province of Córdoba, officials said. The cause of the accident was not immediately clear.",
            "content": "The trains collided at around 7:45 p.m. in Adamuz, near the city of Córdoba, along the main high-speed rail line connecting southern Spain with Madrid, the country’s landlocked capital.\nThe rear cars of the first train left the tracks and spilled ont... [3862 chars]",
            "url": "https://www.nytimes.com/live/2026/01/18/world/spain-high-speed-train-derailment",
            "image": "https://static01.nyt.com/images/2026/01/18/multimedia/18spain-train-carousel-1/18spain-train-carousel-1-facebookJumbo.jpg",
            "publishedAt": "2026-01-19T04:43:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "79d8b141d707872715152479e53d15b0",
            "title": "Snow winds down in New York City. Map shows totals throughout the Tri-State Area.",
            "description": "Snow fell in New York City and across the Tri-State Area on Sunday morning and evening, leaving a good amount to measure in its wake.",
            "content": "Snow fell in New York City and across the Tri-State Area on Sunday morning and evening, leaving a good amount to measure in its wake.\nIt was a First Alert Weather Day for New York, New Jersey and Connecticut.\nWatch: 2-part storm drops 2-5 inches of s... [1948 chars]",
            "url": "https://www.cbsnews.com/newyork/news/how-much-snow-nyc-this-weekend-january-17-18-2026/",
            "image": "https://assets2.cbsnewsstatic.com/hub/i/r/2022/02/23/5d9a8619-5f66-492e-9db7-d1aeff3fafcb/thumbnail/1200x630/5652bf300bf0d5854c4042b549dab128/first-alert-weather-snow.png",
            "publishedAt": "2026-01-19T04:38:36Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "f34887bb1fedd651a752588bd7ec40b0",
            "title": "Springsteen tells ICE ‘get the f--- out,’ pleads for America’s future at surprise N.J. performance",
            "description": "The annual benefit concert returned to Red Bank Saturday night",
            "content": "Nearing the end of his surprise performance in Red Bank Saturday night, Bruce Springsteen paused to address the crowd, hoping not to be “out of order” and disrupt the benefit concert’s otherwise convivial atmosphere.\nSpringsteen began to explain the ... [4849 chars]",
            "url": "https://www.nj.com/entertainment/2026/01/springsteen-tells-ice-get-the-f-out-pleads-for-americas-future-at-surprise-nj-performance.html",
            "image": "https://www.nj.com/resizer/v2/IEDJKGUMNFAZVI6ZC5KDBG73QE.png?auth=dec1cd7c3cfb685e870d7c1b6d93bca39dedc4160c4654f0cd76a4f047b58783&width=1280&smart=true&quality=90",
            "publishedAt": "2026-01-19T04:31:00Z",
            "lang": "en",
            "source": {
                "id": "c77b047cb1d19e99490315d05f5fec0f",
                "name": "NJ.com",
                "url": "https://www.nj.com"
            }
        }
    ]
}

Categories