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": 505174,
    "articles": [
        {
            "id": "db2782155395c49a4e7851a3591274d4",
            "title": "Ty Simpson says he had \"secret meeting\" with Sean McVay before draft",
            "description": "Simpson previously had said he had only a \"brief\" meeting with Rams scouts at the Alabama Pro Day.",
            "content": "After he was drafted by the Rams, quarterback Ty Simpson said he had only a “brief” meeting with Rams scouts at the Alabama Pro Day workout. On Monday, Simpson amended that answer.\nVia Sarah Barshop of ESPN, Simpson told Ian Fitzsimmons of ESPN Radio... [1450 chars]",
            "url": "https://www.nbcsports.com/nfl/profootballtalk/rumor-mill/news/ty-simpson-says-he-had-secret-meeting-with-sean-mcvay-before-draft",
            "image": "https://nbcsports.brightspotcdn.com/dims4/default/34d0839/2147483647/strip/true/crop/7004x3940+0+0/resize/1440x810!/quality/90/?url=https%3A%2F%2Fnbc-sports-production-nbc-sports.s3.us-east-1.amazonaws.com%2Fbrightspot%2F08%2F18%2F1426c3f44e96affac338be42b1cc%2Fhttps-delivery-gettyimages.com%2Fdownloads%2F2272977126",
            "publishedAt": "2026-04-28T02:10:45Z",
            "lang": "en",
            "source": {
                "id": "dc8f73f077072c35626eba314ee483bd",
                "name": "NBC Sports",
                "url": "https://www.nbcsports.com"
            }
        },
        {
            "id": "1b13d8882a2475b8fbf30d9b6ec3eda0",
            "title": "Guardians To Select Travis Bazzana",
            "description": "The Guardians are calling up one of the top prospects in baseball. Read more about the Travis Bazzana promotion at MLB Trade Rumors.",
            "content": "The Guardians are promoting 2024 first overall pick Travis Bazzana, reports Jeff Passan of ESPN. He should take over as the everyday second baseman. Cleveland still has an opening on the 40-man roster after waiving Kolby Allard a couple weeks ago. Th... [3094 chars]",
            "url": "https://www.mlbtraderumors.com/2026/04/guardians-to-select-travis-bazzana.html",
            "image": "https://cdn.mlbtraderumors.com/files/2026/04/USATSI_28635528-1024x683.jpg",
            "publishedAt": "2026-04-28T01:20:06Z",
            "lang": "en",
            "source": {
                "id": "95e9972ed9d1a75fccc1269425e6b80e",
                "name": "MLB Trade Rumors",
                "url": "https://www.mlbtraderumors.com"
            }
        },
        {
            "id": "542a0b6112e0ba1f0b82ecf278ceb936",
            "title": "In pictures: King Charles and Queen Camilla begin US state visit",
            "description": "King Charles III and Queen Camilla were greeted by a military band and honour guard as they arrived for their four-day state visit.",
            "content": "King Charles III and Queen Camilla have arrived in the US at the start of their four-day state visit to the US - the first since Queen Elizabeth II's state visit in 2007.\nThe trip, which comes as the US approaches the 250th anniversary of its indepen... [400 chars]",
            "url": "https://www.bbc.com/news/articles/c86e6z26xdpo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/7d83/live/1c7fbd60-4270-11f1-b55d-0f258dce1735.jpg",
            "publishedAt": "2026-04-28T01:08:45Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories