Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 227010,
    "articles": [
        {
            "id": "d23f78b30947b93f7d4c4a03dc098665",
            "title": "Danish election: Exit poll says Frederiksen is on track to win after Trump clash",
            "description": "Victory for the center-left prime minister will set up tricky coalition talks, with centrist chief Lars Løkke Rasmussen as potential kingmaker.",
            "content": "Prime Minister Mette Frederiksen is on track to win Denmark’s election despite her Social Democrats suffering their worst result in more than century, an exit poll signaled Tuesday night.\nThe Social Democrats are forecast to secure the most votes in ... [1949 chars]",
            "url": "https://www.politico.eu/article/danish-election-exit-poll-says-mette-frederiksen-is-on-track-to-win/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2026/03/24/GettyImages-2267687947-scaled.jpg",
            "publishedAt": "2026-03-24T19:05:00Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu"
            }
        },
        {
            "id": "b25b7507d84485f829bd73a8e8213f8b",
            "title": "Al menos un muerto y dos heridos en el norte de Israel tras un ataque del grupo terrorista Hezbollah con misiles y drones",
            "description": "La víctima, una mujer de unos 30 años, falleció tras el impacto de un proyectil en Mahanayim Junction. Los servicios de emergencia confirmaron que atendieron a varias personas con crisis de ansiedad tras el bombardeo",
            "content": "Un nuevo ataque con cohetes lanzado por el grupo terrorista Hezbollah este martes en el norte de Israel dejó una mujer muerta y dos heridos leves, según informaron equipos médicos en el lugar.\nEl impacto de uno de los proyectiles en la zona de Mahana... [3413 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/03/24/al-menos-un-muerto-y-dos-heridos-en-el-norte-de-israel-tras-un-ataque-del-grupo-terrorista-hezbollah-con-misiles-y-drones/",
            "image": "https://www.infobae.com/resizer/v2/W6SPM2YP6BHQVMTQNR5EHBGO54.PNG?auth=eca372c5ff09124b8c2e64fcc0caa17aae9783985fa338649b3951d088a186d3&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-03-24T18:56:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "5fe4f7612bdc96ba8135ce1403598541",
            "title": "Israel's military wants more weeks to fight Iran, officials say : NPR",
            "description": "The Israeli military estimates it would need several more weeks of fighting to complete its war goals in Iran, at a time when President Trump says the U.S. is negotiating an end to the war.",
            "content": "Click here to listen to NPR's State of the World podcast, a human perspective on global stories in just a few minutes, every weekday.\nTEL AVIV, Israel — The Israeli military estimates it would need several more weeks of fighting to complete its war g... [2306 chars]",
            "url": "https://www.npr.org/2026/03/24/nx-s1-5759317/israel-iran-war",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/5640x3173+0+332/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F88%2F67%2F2ef132174289a22856e7fafd83bf%2Fgettyimages-2267557871.jpg",
            "publishedAt": "2026-03-24T18:42:30Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories