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": 556920,
    "articles": [
        {
            "id": "7ed3da5f800d369e6b7613c582cf6384",
            "title": "Best Prime Day laptop deals: Save up to $850 on MacBooks, gaming laptops",
            "description": "The best Prime Day laptop deals are going to the 15-inch Apple MacBook Air, a cheap Windows laptop, and lots of gaming laptops.",
            "content": "Table of Contents\nThe ongoing global RAM shortage has led most PC makers to raise their laptop prices this year. As of this week, that even includes Apple: All of its MacBooks are now at least $100 more expensive than they were at launch. (Goodbye, $... [7323 chars]",
            "url": "https://mashable.com/tech/best-prime-day-laptop-deals-last-chance-2026",
            "image": "https://helios-i.mashable.com/imagery/articles/06cVzDbLfeuU5gxRC0u8qQP/hero-image.fill.size_1200x675.v1782486491.png",
            "publishedAt": "2026-06-27T05:54:54Z",
            "lang": "en",
            "source": {
                "id": "46629ea6ebf50ca97b330731a94e40b7",
                "name": "Mashable",
                "url": "https://mashable.com"
            }
        },
        {
            "id": "63f01c68ef678f89726ca4b39b6efb4b",
            "title": "U.S. government gives Anthropic green light for limited re-release of Mythos 5",
            "description": "The U.S. government is allowing Anthropic to deploy its Mythos 5 model to a select group of customers and partners, according to a letter from Commerce Secretary Howard Lutnick to Anthropic that was seen by NBC News",
            "content": "The U.S. government is allowing Anthropic to deploy its Mythos 5 model to a select group of customers and partners, according to a letter from Commerce Secretary Howard Lutnick to Anthropic that was seen by NBC News.\nIn the letter, Lutnick wrote that... [4168 chars]",
            "url": "https://www.nbcnews.com/tech/tech-news/us-government-gives-anthropic-green-light-limited-re-release-mythos-5-rcna352018",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/260626-Commerce-Secretary-Howard-Lutnick-vsb-2107-d967ef.jpg",
            "publishedAt": "2026-06-27T02:26:00Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "d191e0240772cac6ebbc43888b9c0676",
            "title": "Loss to Turkey proved to be invaluable for USMNT",
            "description": "Every coach at the World Cup says the knockout rounds are all that matter. Very few are willing to prove it. Mauricio Pochettino did.",
            "content": "INGLEWOOD, Calif. — Every coach at the World Cup says the knockout rounds are all that matter.\nVery few are willing to prove it.\nMauricio Pochettino did.\nAfter the United States had already wrapped up first place in Group D, 10 new starters walked on... [3359 chars]",
            "url": "https://nypost.com/2026/06/26/sports/loss-to-turkey-proved-to-be-invaluable-for-usmnt/",
            "image": "https://nypost.com/wp-content/uploads/sites/2/2026/06/newspress-collage-m7iklnvu1-1782523506883.jpg?quality=75&strip=all&1782509150&w=1200",
            "publishedAt": "2026-06-27T02:21:00Z",
            "lang": "en",
            "source": {
                "id": "9d7e5ab9f28d430ac851e2b94640216c",
                "name": "New York Post",
                "url": "https://nypost.com"
            }
        }
    ]
}

Categories