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": 229902,
    "articles": [
        {
            "id": "91a4eb6d00265c23313ce06f26d15f84",
            "title": "Ucrania negó estar detrás de los explosivos hallados junto a un gasoducto en Serbia y apuntó a una posible maniobra rusa",
            "description": "El Gobierno ucraniano sostuvo que las acusaciones lanzadas desde Budapest carecen de pruebas y sugirió que el episodio podría responder a una operación de Moscú en plena recta final de las elecciones legislativas húngaras",
            "content": "El Gobierno de Ucrania desmintió este domingo cualquier implicación en el hallazgo de dos paquetes de explosivos junto al gasoducto TurkStream en el norte de Serbia, una infraestructura clave para el suministro de gas ruso hacia Hungría.\nKiev sostuvo... [3309 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/04/05/ucrania-nego-su-implicacion-en-los-explosivos-hallados-junto-a-un-gasoducto-en-serbia-y-apunto-a-una-posible-maniobra-rusa/",
            "image": "https://www.infobae.com/resizer/v2/3LRIWQGI7JCKBF6CAWECOW3HXE.JPG?auth=609eaa6b75432c09ccc90b06b7d1ce67dcff9115d291aeb1e03489cbd7c569a8&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-04-05T23:59:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "0f20fc61db2bd96f1acbb8449815975f",
            "title": "4 injured, 4 feared trapped under rubble in Iranian missile strike on Haifa building",
            "description": "One person in serious condition as rescue services search for 4 missing others, including elderly people and a child; 6 lightly hurt as Hezbollah rocket hits Deir al-Asad",
            "content": "Four people were injured, including one seriously, after an Iranian ballistic missile struck a residential building in Haifa on Sunday, as northern Israel faced near-constant missile and drone attacks from both Tehran and its Lebanese terror proxy He... [5227 chars]",
            "url": "https://www.timesofisrael.com/4-injured-4-feared-trapped-under-rubble-in-iranian-missile-strike-on-haifa-building/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/04/AP26095652887293.jpg",
            "publishedAt": "2026-04-05T23:08:50Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        },
        {
            "id": "f709a9ff7f26e640b32df9d04cb8b082",
            "title": "Oil rises as Trump warns Iran to open Strait of Hormuz by Tuesday",
            "description": "President Donald Trump warned Sunday in an expletive-filled social media post that Iran would be \"living in Hell\" if they do not open the Strait",
            "content": "Oil prices rose on Sunday with U.S. crude topping $114 per barrel, after President Donald Trump gave Iran until Tuesday to open the Strait of Hormuz or face attacks on its power plants.\nU.S. crude oil futures for May pared earlier gains to rise 0.5% ... [2122 chars]",
            "url": "https://www.cnbc.com/2026/04/05/crude-oil-prices-iran-war-strait-hormuz.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108286707-1775141666721-gettyimages-2242929815-ed_583470.jpeg?v=1775141689&w=1920&h=1080",
            "publishedAt": "2026-04-05T22:09:19Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        }
    ]
}

Categories