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": 407316,
    "articles": [
        {
            "id": "d66919df1caf57486c39c896f2fa24a7",
            "title": "Actor Shia LaBeouf arrested in New Orleans on Mardi Gras Day for alleged assaults, police say",
            "description": "Actor Shia LaBeouf was arrested early Mardi Gras morning after allegedly assaulting two men; he faces two simple battery charges, New Orleans police say.",
            "content": "NEW ORLEANS — Actor Shia LaBeouf has been released from custody on the condition that he will attend future court hearings, Orleans Parish records show. He was arrested early Mardi Gras Day after two men reported they were assaulted by the actor, acc... [1207 chars]",
            "url": "https://www.wwltv.com/article/news/local/actor-shia-labeouf-arrested-in-new-orleans-on-mardi-gras-day-court-records-show/289-731f1c47-bde6-4cd8-9dff-e5b0fc8cc18d",
            "image": "https://media.wwltv.com/assets/WWL/images/c5c704a7-7d3a-45ec-9593-1e0cd53ff9e2/20260217T152405/c5c704a7-7d3a-45ec-9593-1e0cd53ff9e2_1140x641.jpg",
            "publishedAt": "2026-02-18T01:54:35Z",
            "lang": "en",
            "source": {
                "id": "6538a16f4c3c301dac9dc1370073f58f",
                "name": "WWLTV.com",
                "url": "https://www.wwltv.com"
            }
        },
        {
            "id": "2f862c13e3b5986a9122eadbf405b63e",
            "title": "Judge declares mistrial in Texas ‘antifa’ protest case over attorney’s T-shirt",
            "description": "Lawyer for defendants accused of terrorism at ICE protest decried by Trump appointee over shirt’s potential for ‘bias’",
            "content": "A federal judge in Texas declared a mistrial on Tuesday after a defense lawyer wore a shirt in court with images from the civil rights movement, delaying a closely watched case in which the Trump administration is accusing a group of protesters of be... [5384 chars]",
            "url": "https://www.theguardian.com/us-news/2026/feb/17/judge-texas-mistrial-antifa-ice",
            "image": "https://i.guim.co.uk/img/media/94ee09f932be333d65ffc2f410580ce7958b4340/683_0_6827_5464/master/6827.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=81f028e73048cdd73af90536eb988f9b",
            "publishedAt": "2026-02-18T01:24:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "79ea23d9c2c879337fa7a90aef11df8a",
            "title": "Jaden Rashada reaches settlement in NIL lawsuit against Billy Napier, Florida booster",
            "description": "Jaden Rashada has reached a settlement in his NIL lawsuit against Billy Napier and a Florida booster, per court records.",
            "content": "Former Florida quarterback Jaden Rashada has reached a settlement in his NIL lawsuit against ex-Gators coach Billy Napier and a UF booster, according to court records. Terms of the settlement are confidential.\nA mediation conference took place Feb. 1... [1860 chars]",
            "url": "https://www.on3.com/nil/news/jaden-rashada-reaches-settlement-nil-lawsuit-against-billy-napier-florida-booster/",
            "image": "https://on3static.com/uploads/dev/assets/cms/2024/11/01081924/Napier-Rashada-AFI.png",
            "publishedAt": "2026-02-18T01:17:13Z",
            "lang": "en",
            "source": {
                "id": "fcf9eb47b9ced05a52a536f48e2d155a",
                "name": "On3",
                "url": "https://www.on3.com"
            }
        }
    ]
}

Categories