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": 245730,
    "articles": [
        {
            "id": "d2718408c75d315ff62d9acc3fba67bb",
            "title": "What We’ve Learned From 10 Days of War",
            "description": "President Trump has given confusing signals about when the fighting might end, and leaders have been scrambling to contain the possible fallout.",
            "content": "This transcript was created using speech recognition software. While it has been reviewed by human transcribers, it may contain errors. Please review the episode audio before quoting from this transcript and email transcripts@nytimes.com with any que... [36514 chars]",
            "url": "https://www.nytimes.com/2026/03/10/podcasts/the-daily/iran-war-middle-east-oil.html",
            "image": "https://static01.nyt.com/images/2026/03/10/multimedia/10DAILY-war-week1-zpjq/10DAILY-war-week1-zpjq-facebookJumbo.jpg",
            "publishedAt": "2026-03-10T16:01:52Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "0ffd43a9426c5631ce149af17e7fb715",
            "title": "Iran signals Hormuz safe passage to countries expelling U.S. and Israeli diplomats",
            "description": "The disruption in the Strait of Hormuz, a corridor for global oil flows, rapidly lifted crude prices and increased volatility in energy markets, inflation expectations and safe-haven assets.",
            "content": "Summary:\nIran’s Islamic Revolutionary Guard Corps (IRGC) says Arab or European countries that expel Israeli and U.S. ambassadors will be granted full freedom to transit the Strait of Hormuz.\nThe statement was carried by Iranian state media and appear... [2615 chars]",
            "url": "https://investinglive.com/commodities/iran-signals-hormuz-safe-passage-to-countries-expelling-us-and-israeli-diplomats-20260309/",
            "image": "https://images.investinglive.com/images/IRAN%20OIL%2002-03_id_9ee1d4b1-3da3-4db0-b71f-56d40f119ad3_size975.jpg",
            "publishedAt": "2026-03-10T13:26:05Z",
            "lang": "en",
            "source": {
                "id": "6646fbe1e17181493308fc8de7f300ff",
                "name": "investingLive",
                "url": "https://investinglive.com"
            }
        },
        {
            "id": "0dc1da6260ce964d5990c6f19c87152d",
            "title": "Iran vows to fight 'as long as it takes,' threatens Trump with 'elimination'",
            "description": "IRGC says oil blockade will continue, FM rejects Trump's claim war could be over 'soon' and asserts US and Israel failed to meet aims; Tehran continues to lob missiles at neighbors",
            "content": "Iran’s Foreign Minister Abbas Araghchi said Tuesday his country would keep fighting as long as necessary, casting doubt on US President Donald Trump’s insistence the previous day that the conflict would be over “soon.”\nAnd the Islamic Republic’s secu... [4544 chars]",
            "url": "https://www.timesofisrael.com/iran-vows-to-fight-as-long-as-it-takes-threatens-trump-with-elimination/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/03/lariarag.jpg",
            "publishedAt": "2026-03-10T12:13:45Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories