Flag of United States

United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 428030,
    "articles": [
        {
            "id": "8362624ddfc280679838df0b9163f6e5",
            "title": "Australia grants asylum to five Iranian female athletes",
            "description": "The five players, including team captain Zahra Ghanbari, sought protection after the team were branded \"wartime traitors\" for refusing to sing their national anthem before an Asian Cup match.",
            "content": "Australian police extracted five Iranian women soccer players from the team's hotel before they were granted asylum, the interior minister said on Tuesday, as details of their escape from Iranian government minders emerged.\nThe five players, includin... [2563 chars]",
            "url": "https://www.jpost.com/middle-east/iran-news/article-889421",
            "image": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/710675",
            "publishedAt": "2026-03-10T07:26:44Z",
            "lang": "en",
            "source": {
                "id": "78834c45a26f98bca295cc641123cf7f",
                "name": "The Jerusalem Post",
                "url": "https://www.jpost.com"
            }
        },
        {
            "id": "a7d8c0acf6b3787a528187642baaaf41",
            "title": "JetBlue ground stop lifted soon after it began",
            "description": "Shortly after all JetBlue flights were grounded by the FAA due to what the agency said was a JetBlue request, the carrier said it had resumed operations.",
            "content": "Shortly after all JetBlue flights were grounded by the Federal Aviation Administration due to what the agency said was a JetBlue request, the carrier said early Tuesday that the ground stop was over.\n\"A brief system outage has been resolved and we ha... [617 chars]",
            "url": "https://www.cbsnews.com/news/faa-grounds-all-jetblue-flights-after-airline-asks-it-to-agency-says/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2025/05/29/ecfaf426-13c5-441b-bc94-dfe79d6bfb90/thumbnail/1200x630/0d09962274f5ebf22917f0204ffc1826/cbsn-fusion-jetblue-united-announce-points-partnership-thumbnail.jpg",
            "publishedAt": "2026-03-10T05:57:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "ec6c29e513d427b028414a50395d4878",
            "title": "FAA briefly grounds JetBlue flights",
            "description": "The Federal Aviation Administration briefly grounded all JetBlue flights due to a request from the airline, the agency said in a notice posted to its website early Tuesday morning.",
            "content": "NEW YORK (AP) — The Federal Aviation Administration briefly grounded all JetBlue flights early Tuesday morning due to a request from the airline, the agency said in a notice posted to its website.\nIt was not immediately clear why JetBlue requested th... [358 chars]",
            "url": "https://apnews.com/article/faa-ground-stop-jetblue-e990b118812f467d904d92375b984d71",
            "image": "https://dims.apnews.com/dims4/default/60436b0/2147483647/strip/true/crop/3000x1999+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fstorage.googleapis.com%2Fafs-prod%2Fmedia%2Fcfc364242b3f47879b6e7c3798bfdd63%2F3000.jpeg",
            "publishedAt": "2026-03-10T05:54:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories