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": 242440,
    "articles": [
        {
            "id": "b365b7101028db542eec19313f9984b5",
            "title": "Gas prices jump, Strait of Hormuz in chaos",
            "description": "Iran took credit for attacks on ships in the Strait of Hormuz as U.S. gas prices reached a national average of $3.59 a gallon.",
            "content": "5:51 pm ET\nFeds warn California could be drone target tied to Iran conflict\nJames Ward and Noe Padilla\nFederal authorities have warned California law enforcement agencies that the state could be a potential target of a drone attack tied to the escala... [25684 chars]",
            "url": "https://www.usatoday.com/live-story/news/world/2026/03/11/iran-war-live-updates-us-israel-strait-hormuz/89093377007/",
            "image": "https://www.usatoday.com/gcdn/authoring/authoring-images/2026/03/11/USAT/89097927007-ships-in-strait-of-hormuz-hit.jpg?crop=1919,1079,x0,y0&width=1919&height=1079&format=pjpg&auto=webp",
            "publishedAt": "2026-03-11T22:41:05Z",
            "lang": "en",
            "source": {
                "id": "8eec8fc7a9ec8be488bc7411d0801c60",
                "name": "USA Today",
                "url": "https://www.usatoday.com"
            }
        },
        {
            "id": "76932d248507b334b93a15afe08b7f28",
            "title": "Jaw-Dropping Scale of Troops Wounded by Trump’s War Is Leaked",
            "description": "Scores of U.S. soldiers were gravely injured—but the Pentagon has not been upfront about it.",
            "content": "The devastating toll of Iran’s counterattack on U.S. service members after President Donald Trump’s surprise strikes on the country is even more severe than previously known.\nA deadly attack that killed six U.S. service members has also left dozens o... [3781 chars]",
            "url": "https://www.thedailybeast.com/military-hospital-flooded-with-injured-troops-from-trumps-iran-war/",
            "image": "https://www.thedailybeast.com/resizer/v2/BQVYHNVJR5ACDIVXHWPKNULF6A.JPG?smart=true&auth=942a19c3ebf803ad96df58822f4b4957a1155b608583c70cd00c42c6687b6005&width=1200&height=630",
            "publishedAt": "2026-03-11T21:38:00Z",
            "lang": "en",
            "source": {
                "id": "e3fd974e36370d094fc026102a75c80f",
                "name": "The Daily Beast",
                "url": "https://www.thedailybeast.com"
            }
        },
        {
            "id": "a16cdfa9db66344a6763cb0fc54039d4",
            "title": "La liberación de reservas estratégicas no frena el avance del petróleo: los mercados europeos cerraron con pérdidas",
            "description": "La cotización internacional del crudo se incrementó nuevamente ante la persistencia de tensiones geopolíticas en Oriente Medio, mientras las bolsas de Europa y Estados Unidos finalizaron la jornada con pérdidas en diversos sectores",
            "content": "Los precios del petróleo prolongaron su senda alcista este miércoles, mientras las principales bolsas mundiales cerraron a la baja, en un contexto marcado por el conflicto en Oriente Medioy la decisión de la Agencia Internacional de la Energía (AIE) ... [4257 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/03/11/la-liberacion-de-reservas-estrategicas-no-frena-el-avance-del-petroleo-y-los-mercados-europeos-cierran-con-perdidas/",
            "image": "https://www.infobae.com/resizer/v2/XYG6NQFHB5G63BTPJVBDZCNBKQ.JPG?auth=f7619eccb68787ef8407712d7bf8432532698b744a5ba56e689ea47cd11781ed&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-03-11T21:30:57Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

Categories