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": 210022,
    "articles": [
        {
            "id": "6c2aa26ade334c314d6802171eccbd27",
            "title": "‘I just want to stop hearing about it’: a weary South Korea awaits verdict on Yoon insurrection charges",
            "description": "Yoon Suk Yeol could face the death penalty when judges rule on the martial law crisis that many in South Korea see as a dark moment they would rather forget",
            "content": "South Korea is awaiting one of the most consequential court rulings in decades this week, with judges due to deliver their verdict on insurrection charges against the former president Yoon Suk Yeol and prosecutors demanding the death penalty.\nWhen Yo... [5812 chars]",
            "url": "https://www.theguardian.com/world/2026/feb/17/yoon-suk-yeol-south-korea-trial-verdict",
            "image": "https://i.guim.co.uk/img/media/99e8429dec86d4869bf5db432dca3c3ee6a8f3c0/1163_657_3762_3010/master/3762.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=ba0200c8fdb7e0022d9b86165922a5d5",
            "publishedAt": "2026-02-17T01:58:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "097ef6cd1283ce1b96a2b969f828dcfa",
            "title": "Petrolero entra en la bahía de Matanzas en plena crisis energética en Cuba",
            "description": "El buque Nicos I.V. atracó cerca del complejo de logística energética de Matanzas, aunque se desconoce el tipo y volumen del combustible que transporta.",
            "content": "Un petrolero con carga entró este lunes en la bahía de Matanzas, en el occidente de Cuba, y atracó cerca del puerto de logística energética de la ciudad en pleno bloqueo energético de Estados Unidos a la isla, según confirmó la agencia EFE.\nSe trata ... [3460 chars]",
            "url": "https://www.cibercuba.com/noticias/2026-02-17-u1-e135253-s27061-nid321029-petrolero-entra-bahia-matanzas-plena-crisis",
            "image": "https://cdn0.celebritax.com/sites/default/files/styles/watermark_100/public/1771291754-petrolero-entra-bahia-matanzas-plena-crisis-energetica-cuba.jpg",
            "publishedAt": "2026-02-17T01:30:38Z",
            "lang": "es",
            "source": {
                "id": "a619450f68a89d836617874d536ffa7b",
                "name": "CiberCuba",
                "url": "https://www.cibercuba.com"
            }
        },
        {
            "id": "a3a1c8d426005b154bd8a1f4b6665d8c",
            "title": "U.S. Ally Humiliates Trump by Degrading Him on Presidents Day",
            "description": "A massive parade in Germany known for political satire coincided with Presidents Day in the U.S.",
            "content": "Germans tore into Donald Trump on their biggest carnival of the year—and on Presidents Day in the U.S.\nThe 79-year-old American leader was the central character in several floats that paraded through western Germany for Rosenmontag, or Rose Monday, a... [1337 chars]",
            "url": "https://www.thedailybeast.com/us-ally-humiliates-trump-by-degrading-him-on-presidents-day/",
            "image": "https://www.thedailybeast.com/resizer/v2/HXEQJGWBUREKLDZLYVLDWWFUDI.jpg?smart=true&auth=81e1ef362443c5921deeb44e503869d6e33ce3c6b609b309a34bbb5387c2dd13&width=1200&height=630",
            "publishedAt": "2026-02-17T01:12:00Z",
            "lang": "en",
            "source": {
                "id": "e3fd974e36370d094fc026102a75c80f",
                "name": "The Daily Beast",
                "url": "https://www.thedailybeast.com"
            }
        }
    ]
}

Categories