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": 242546,
    "articles": [
        {
            "id": "802b40819a8b1907740847c0350afcff",
            "title": "Trump says he is reviewing a new Iran proposal to end the war",
            "description": "President Donald Trump says he is reviewing a new Iranian proposal to end the war but expressed skepticism it would be acceptable.",
            "content": "WEST PALM BEACH, Fla. (AP) — President Donald Trump said on Saturday that he was reviewing a new Iranian proposal to end the war but also expressed skepticism it would lead to a deal.\n“I’ll let you know about it later,” he said before boarding Air Fo... [4590 chars]",
            "url": "https://apnews.com/article/iran-us-war-ceasefire-negotiations-strait-9317c11e51ba8dfa527b424f931fe04b",
            "image": "https://dims.apnews.com/dims4/default/785547a/2147483647/strip/true/crop/8640x5757+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F0d%2Fd3%2F4170d28e6521a5acf503c79ad019%2F99c0071012f84333bd32046749db7a9a",
            "publishedAt": "2026-05-02T22:43:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "5b40aa05f9bf15040e2d31219d959640",
            "title": "Qatar advirtió al régimen de Irán sobre las repercusiones negativas internacionales de mantener el bloqueo del estrecho de Ormuz",
            "description": "Doha emitió un comunicado oficial reafirmando su compromiso con los esfuerzos diplomáticos para evitar una nueva escalada del conflicto, destacando la importancia de la cooperación internacional para mantener la estabilidad en la región",
            "content": "El ministro de Exteriores qatarri, Mohamed bin Abdulrahman, advirtió este sábado a su homólogo iraní, Abás Araqchí, sobre las repercusiones negativas en el suministro mundial de energía y alimentos si continúa el bloqueo del estrecho de Ormuz. La adv... [2855 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/05/02/qatar-advirtio-al-regimen-de-iran-sobre-las-repercusiones-negativas-internacionales-de-mantener-el-bloqueo-del-estrecho-de-ormuz/",
            "image": "https://www.infobae.com/resizer/v2/JOD72HB5HFAGPGO3PU3GNG2SAA.JPG?auth=dc1abc487ab94b525eccc26ffbdce2647776cf46054ce0a914465dce491a182d&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-05-02T19:49:44Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "99ea3cc87f90ace50dd5716c62a7bd84",
            "title": "Taiwan's Lai lands in Eswatini in a trip delayed by lack of overflight clearance",
            "description": "Eswatini remains the only African nation without tariff-free access to China's market due to its ties with Taiwan.",
            "content": "TAIPEI, Taiwan — Taiwan's President Lai Ching-te said he arrived in the African nation of Eswatini on Saturday, days after his government was forced to push back the trip when several countries withdrew permission for him to fly over their territorie... [2483 chars]",
            "url": "https://www.npr.org/2026/05/02/g-s1-119911/taiwans-lai-lands-in-eswatini-in-a-trip-delayed-by-lack-of-overflight-clearance",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/6000x3373+0+4/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F3d%2F2d%2F293994cd4bfdb2814c227112dae1%2Fap26122453545889.jpg",
            "publishedAt": "2026-05-02T19:48:30Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories