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": 413820,
    "articles": [
        {
            "id": "1225b07b59e54fc694272549d2e212a3",
            "title": "Jack Osbourne announces birth of daughter Ozzy Matilda Osbourne",
            "description": "Jack Osbourne has announced the birth of his new daughter, Ozzy Matilda Osbourne.",
            "content": "Jack Osbourne has announced the birth of his new daughter, Ozzy Matilda Osbourne.\nThe reality star and son of the late rock legend Ozzy Osbourne posted a reel to Instagram with a black and white photo of the newborn, lying on a flowery backdrop.\nNext... [821 chars]",
            "url": "https://www.yahoo.com/entertainment/celebrity/articles/jack-osbourne-announces-birth-daughter-010252711.html",
            "image": "https://s.yimg.com/os/en/cover_media_us_articles_275/3962bd97d7eb6ee8b972424924f90bdf",
            "publishedAt": "2026-03-12T06:05:00Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        },
        {
            "id": "43325e19032ec714566221b310c9fb4f",
            "title": "Maxx Crosby commits after nixed trade to Ravens: I'm a Raider",
            "description": "Maxx Crosby made his first public comments since the Ravens backed out of a trade that would've sent him to Baltimore, writing on X on Wednesday night, \"Im a Raider. I'm back.\"",
            "content": "HENDERSON, Nev. -- All-Pro edge rusher Maxx Crosby expressed his commitment to the Las Vegas Raiders on Wednesday night in his first public comments since the Ravens nixed a trade that would've sent him to Baltimore.\n\"Everything Happens For A Reason,... [1951 chars]",
            "url": "https://www.espn.com/nfl/story/_/id/48181105/maxx-crosby-commits-nixed-trade-ravens-raider",
            "image": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0207%2Fr1611550_1296x729_16%2D9.jpg",
            "publishedAt": "2026-03-12T05:50:14Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "id": "4925ddb3066703cf9be5f47f9c25d9fe",
            "title": "N ot everyone pleased about Bam Adebayo's 83-point night : NPR",
            "description": "Detractors point to Adebayo's one-of-a-kind stat line — 43 field goal attempts, 22 3-point attempts and, most of all, NBA records of 36 free throws and 43 attempts — as proof of stat-padding.",
            "content": "MIAMI — The Miami Heat led the Washington Wizards by 25 points with 2:56 left. The game was essentially over, the outcome decided. And Bam Adebayo got called for an offensive foul that, under normal circumstances, would not have mattered.\nThese were ... [6292 chars]",
            "url": "https://www.npr.org/2026/03/12/g-s1-113393/bam-adebayo-83-point-not-everyone-pleased",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/6000x3375+0+313/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2Fd1%2Fd7%2F4897429346749b48fe65dacbaa4e%2Fap26070186730331.jpg",
            "publishedAt": "2026-03-12T05:48:31Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories