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": 203604,
    "articles": [
        {
            "id": "fdbab1bf717202c01823738694fc8f2e",
            "title": "Owner of Swiss bar where deadly New Year's fire killed 40 detained by prosecutors: Officials",
            "description": "Prosecutors detained the owner of a Swiss bar where a deadly News Year's Day fire killed 40 people and injured 116 others, according to officials.",
            "content": "Prosecutors on Friday detained the owner of a Swiss bar where a deadly New Year's Day fire killed 40 people and injured 116 others, according to officials.\nJacques Moretti was placed in pre-trial detention after a meeting with prosecutors in Sion, th... [1561 chars]",
            "url": "https://abcnews.go.com/International/owner-swiss-bar-deadly-new-years-fire-killed/story?id=129058236",
            "image": "https://i.abcnewsfe.com/a/24cd036d-6b25-493f-9550-b39ea5ceab94/swiss-fire-moretti-01-gty-jt-260109_1767973054367_hpMain_16x9.jpg?w=1600",
            "publishedAt": "2026-01-09T16:32:17Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "abcnews.go.com",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "id": "a3b4170c4878be15ba369c45227c1caa",
            "title": "EU-Mercosur mega trade deal: The winners and losers",
            "description": "POLITICO analyzes who is uncorking the Malbec — and who is crying into their Bordeaux (cough, Emmanuel Macron, cough).",
            "content": "Europe’s biggest ever trade deal finally got the nod Friday after 25 years of negotiating.\nIt took blood, sweat, tears and tortured discussions to get there, but EU countries at last backed the deal with the Mercosur bloc — paving the way to create a... [7570 chars]",
            "url": "https://www.politico.eu/article/eu-mercosur-trade-deal-the-winners-and-losers/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2026/01/09/WhatsApp-Image-2026-01-09-at-4.36.10-PM.jpeg",
            "publishedAt": "2026-01-09T16:02:20Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu"
            }
        },
        {
            "id": "d9d0f1bab1d6e5684cb4ea9554c0dfa4",
            "title": "E.U. and South America to Form Free-Trade Zone With 700 Million People",
            "description": "The agreement represents a push for deeper global cooperation, in contrast to the United States turning to coercion in its dealings with other countries.",
            "content": "The European Union, overcoming deep dissension among its members, gave the green light to a sweeping trade pact with four South American countries on Friday that would create one of the largest free-trade zones in the world, connecting markets with m... [1531 chars]",
            "url": "https://www.nytimes.com/2026/01/09/business/economy/european-union-mercosur-trade.html",
            "image": "https://static01.nyt.com/images/2026/01/09/multimedia/09biz-eu-mercosur1-qchz/09biz-eu-mercosur1-qchz-facebookJumbo.jpg",
            "publishedAt": "2026-01-09T15:47:23Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories