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": 402800,
    "articles": [
        {
            "id": "bbc07b263ee4139d6b368a05e64a489d",
            "title": "Liberan bajo fianza al exembajador británico en EE.UU. Peter Mandelson tras ser arrestado por sospecha de mala conducta en un cargo público",
            "description": "La policía informó este lunes que un hombre de 72 años fue trasladado a una comisaría en Londres. Horas después quedó en libertad.",
            "content": "Autor, Olivia Ireland\nTítulo del autor, BBC News\n23 febrero 2026\nActualizado 47 minutos\nTiempo de lectura: 4 min\nEl exembajador británico en Estados Unidos Peter Mandelson fue puesto en libertad bajo fianza, según informa la Policía Metropolitana, ho... [4561 chars]",
            "url": "https://www.bbc.com/mundo/articles/cm2x1e04xy2o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/53ed/live/4c19f990-1107-11f1-9120-a910fc22c6ac.jpg",
            "publishedAt": "2026-02-24T05:03:45Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "5180f4315918d76ab5d49843c6e81007",
            "title": "AJ Styles retires, will be inducted into WWE Hall of Fame",
            "description": "He left the gloves this time, and then got a big surprise from The Undertaker.",
            "content": "How’s this for a tribute?\nWWE announced this week’s episode of Monday Night Raw in Atlanta would be a special tribute to AJ Styles, who lost a career threatening match against GUNTHER at Royal Rumble. All signs pointed to his retiring from profession... [850 chars]",
            "url": "https://www.cagesideseats.com/wwe/420354/aj-styles-retires-wwe-hall-of-fame-2026-inductee-undertaker",
            "image": "https://platform.cagesideseats.com/wp-content/uploads/sites/54/2026/02/AJS.png?quality=90&strip=all&crop=0%2C5.7232192273193%2C100%2C88.553561545361&w=1200",
            "publishedAt": "2026-02-24T03:42:00Z",
            "lang": "en",
            "source": {
                "id": "f0c93ff323489e08f99094e7cf89daf8",
                "name": "Cageside Seats",
                "url": "https://www.cagesideseats.com"
            }
        },
        {
            "id": "1b7e4adee7112855d642431f8f8deeb5",
            "title": "The snowstorm of ’26 was a record-breaker. Here are the totals around Boston.",
            "description": "For the rest of Monday afternoon and evening, the storm that dumped a record-breaking amount of snow on Providence will slowly subside. Here's what to expect.",
            "content": "On Monday afternoon, the storm system that brought record-breaking snowfall to parts of Rhode Island, and a historic storm to Boston and the entire east coast, will continue to slowly meander eastward.\nThis storm is record-breaking for Providence. Pr... [2317 chars]",
            "url": "https://www.wgbh.org/news/local/2026-02-23/the-snowstorm-of-26-was-a-record-breaker-here-are-the-totals-around-boston",
            "image": "https://cdn.grove.wgbh.org/dims4/default/1b20c48/2147483647/strip/true/crop/4890x2567+0+57/resize/1200x630!/quality/70/?url=https%3A%2F%2Fk1-prod-gbh.s3.us-east-2.amazonaws.com%2Fbrightspot%2Fdb%2F10%2F01850a19405ab983e49ea66e7c5d%2F1v7a7568.jpg",
            "publishedAt": "2026-02-24T02:44:31Z",
            "lang": "en",
            "source": {
                "id": "04295d600c49b90824779e9900507473",
                "name": "WGBH",
                "url": "https://www.wgbh.org"
            }
        }
    ]
}

Categories