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": 201836,
    "articles": [
        {
            "id": "720882c8531d20903b064566a28e0d46",
            "title": "Trump slams UK deal to hand over Chagos Islands after he previously backed it",
            "description": "The British government is defending its decision to transfer sovereignty of the Chagos Islands to Mauritius after U.S. President Donald Trump criticized the move.",
            "content": "LONDON (AP) — The British government on Tuesday defended its decision to hand sovereignty of the Chagos Islands to Mauritius, after U.S. President Donald Trump attacked the plan, which his administration had previously supported.\nTrump said that reli... [3316 chars]",
            "url": "https://apnews.com/article/trump-britain-chagos-islands-greenland-0a6ac404299861b43769f57930839825",
            "image": "https://dims.apnews.com/dims4/default/6cf0189/2147483647/strip/true/crop/1200x675+0+127/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F82%2Fd3%2F2b55b4f9f95211dbfd2d73bac3cf%2Fe678c9366bd44746a3cbba6094ea4c72",
            "publishedAt": "2026-01-20T09:01:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "957304f96e513c1403368be7e3fb5fc5",
            "title": "Bessent says US-Europe relations have 'never been closer' despite Greenland crisis",
            "description": "U.S. Treasury Secretary Scott Bessent says America’s relations with Europe remain strong. Speaking on the sidelines of the World Economic Forum annual meeting in Davos, Switzerland, he urged trading partners to “take a deep breath” and let tensions driven by the Trump administration’s new tariff thr",
            "content": "DAVOS, Switzerland (AP) — U.S. Treasury Secretary Scott Bessent on Tuesday said America’s relations with Europe remain strong and urged trading partners to “take a deep breath” and let tensions driven by the Trump administration’s new tariff threats ... [4176 chars]",
            "url": "https://apnews.com/article/denmark-greenland-trump-bessent-davos-ab05ebfaae6a413d1f8125cb9726a4c5",
            "image": "https://dims.apnews.com/dims4/default/13eab06/2147483647/strip/true/crop/8154x4587+0+425/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F8c%2Ffc%2F2b037395dea0f8702fd39db6c153%2F1e93d29d8de342b3973e1d93714d9590",
            "publishedAt": "2026-01-20T08:46:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "e5299205d55d3cc6b8a4849c139e0283",
            "title": "Trump blasts NATO ally, the UK, over Chagos Mauritius deal",
            "description": "The White House voiced its support for the deal last year, but on Tuesday, Trump said it was \"an act of great stupidity.\"",
            "content": "U.S. President Donald Trump has taken aim at another NATO ally on the eve of his appearance at the World Economic Forum in Davos this week, this time lambasting the U.K.\nThe so-called \"special relationship\" between the U.S. and U.K., and President Do... [3420 chars]",
            "url": "https://www.cnbc.com/2026/01/20/trump-uk-chagos-davos-starmer-nato.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108200767-17582092762025-09-18t145923z_420535099_rc2eugay6ayq_rtrmadp_0_usa-trump-britain.jpeg?v=1758209319&w=1920&h=1080",
            "publishedAt": "2026-01-20T07:29:50Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        }
    ]
}

Categories