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": 232052,
    "articles": [
        {
            "id": "11de0cb3b03c083b596eb15425813d98",
            "title": "India has splurged billions on metro trains. But where are the commuters?",
            "description": "Without better last-mile connectivity and affordable fares, metro use is unlikely to improve quickly, say experts.",
            "content": "On a weekday evening last month, Mumbai's southbound Aqua Line metro train nearly emptied out a couple of stops before the final one.\nOn de-boarding, the last station bore the look of a desolate Soviet-era structure rather than a bustling train termi... [6475 chars]",
            "url": "https://www.bbc.com/news/articles/c4g833128vlo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/fc56/live/e2709820-3a3a-11f1-826b-272fcb9e69bd.jpg",
            "publishedAt": "2026-04-19T23:12:10Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "a9f1a4f0855f722fa6e115b60848ebcc",
            "title": "Middle East Oil Pricing Is Cracking Under Pressure",
            "description": "The Platts Dubai benchmark is under severe strain as Hormuz disruptions halt exports, leaving it disconnected from physical oil flows and reducing available pricing grades.",
            "content": "In a “perilous position,” the Platts Dubai benchmark used to price around 18 million barrels per day, nearly a fifth of global supply, is now severely strained by the halt in exports through the Strait of Hormuz. According to Reuters, with most cargo... [5992 chars]",
            "url": "https://oilprice.com/Energy/Oil-Prices/Middle-East-Oil-Pricing-Is-Cracking-Under-Pressure.html",
            "image": "https://d32r1sh890xpii.cloudfront.net/article/1200x675/2026-04-18_rxefj5kun0.jpg",
            "publishedAt": "2026-04-19T23:00:00Z",
            "lang": "en",
            "source": {
                "id": "0bfd2fc1956a6c3bdfd830c196c1fbab",
                "name": "Crude Oil Prices Today | OilPrice.com",
                "url": "https://oilprice.com"
            }
        },
        {
            "id": "c331617f10036787c17715de4b058571",
            "title": "Oil surges after Iran and U.S. attack ships as tensions escalate over Hormuz",
            "description": "Crude oil prices surged Sunday, as the U.S. and Iran teetered on the brink of a renewed war after attacks on commercial ships in the Strait of Hormuz.",
            "content": "Crude oil prices surged Sunday, as the U.S. and Iran teetered on the brink of a renewed war after attacks on commercial ships in the Strait of Hormuz.\nWest Texas Intermediate futures for May delivery rose about 7% to $89.74 per barrel by 6:45 p.m. ET... [1789 chars]",
            "url": "https://www.cnbc.com/2026/04/19/oil-price-iran-war-strait-hormuz-tanker.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108293681-17766249652026-04-18t083700z_335858674_rc2b2kamj747_rtrmadp_0_iran-crisis-strait.jpeg?v=1776624993&w=1920&h=1080",
            "publishedAt": "2026-04-19T22:07:43Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        }
    ]
}

Categories