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": 400226,
    "articles": [
        {
            "id": "ba3475003bab74b2a6cab2e2c7c8d112",
            "title": "Russian opposition leader Alexei Navalny was poisoned by deadly 'dart frog' toxin, Europeans say",
            "description": "Russian opposition leader Alexei Navalny died in prison after being poisoned with a deadly toxin found in Ecuadorian dart frogs, the U.K. and other allies claimed Saturday",
            "content": "Russian opposition leader Alexei Navalny died in prison after being poisoned with a deadly toxin found in Ecuadorian dart frogs, the U.K. and other allies claimed Saturday.\nThere is no possible other explanation other than a deliberate poisoning, Eur... [3197 chars]",
            "url": "https://www.nbcnews.com/world/russia/russian-opposition-leader-alexei-navalny-poisoned-deadly-dart-frog-rcna259064",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-02/260214-navalny-nd-0d9903.jpg",
            "publishedAt": "2026-02-14T14:54:56Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "306d0f6b7594588aded92c8e806296fb",
            "title": "Presidents' Day sales 2026: The best tech deals to shop this weekend from Apple, Sony, Anker and others",
            "description": "Save up to 50 percent on everything from affordable streaming devices and accessories to high-end wearables, wireless headphones and more.",
            "content": "Presidents’ Day is a great time to buy appliances, mattresses and furniture as they are often on sale for the holiday. Tech also gets discounted around this time, but you have to do a bit more digging to find actually good deals. And this year, Presi... [4787 chars]",
            "url": "https://www.engadget.com/deals/presidents-day-sales-2026-the-best-tech-deals-to-shop-this-weekend-from-apple-sony-anker-and-others-163000988.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/6I3noB6OZfzsfea8Wdpz0g--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA-/https://s.yimg.com/os/creatr-uploaded-images/2025-11/c760e800-bb50-11f0-be9b-28e8af3ff9d5",
            "publishedAt": "2026-02-14T14:41:32Z",
            "lang": "en",
            "source": {
                "id": "48e27292ccc1733d7eefd6a41c5655d4",
                "name": "Engadget",
                "url": "https://www.engadget.com"
            }
        },
        {
            "id": "b85f2b1283b232e05cd9d159419fdd4c",
            "title": "CIA investigated secret ‘Havana syndrome’ weapon experiment in Norway",
            "description": "The CIA investigated a Norwegian government experiment with a pulsed-energy machine in which a researcher built and tested a “Havana syndrome” device on himself.",
            "content": "In 2024, a Norwegian researcher skeptical that pulsed-energy weapons could do damage to human brains built a device and tested it on himself. It didn’t go well.\nUpdated\nFebruary 14, 2026 at 9:18 a.m. ESTtoday at 9:18 a.m. EST\nWorking in strict secrec... [368 chars]",
            "url": "https://www.washingtonpost.com/national-security/2026/02/14/havana-syndrome-cia-norway-experiment/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/MG2RCOL5RFISYCHN2NANO2DXMM_size-normalized.JPG&w=1440",
            "publishedAt": "2026-02-14T14:02:00Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories