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": 576818,
    "articles": [
        {
            "id": "5c520a9dcee59a65af11718c729c73f5",
            "title": "US-Iran deal takes 'immediate effect' after both sides sign, Pakistan premier says",
            "description": "Pakistan says that the deal to end the war in Iran is taking ‘immediate effect’ after both sides have signed it, but that there will still be a formal signing ceremony on Friday.",
            "content": "WASHINGTON (AP) — Pakistan says that the deal to end the war in Iran is taking ‘immediate effect’ after both sides have signed it, but that there will still be a formal signing ceremony on Friday.\nPakistani Prime Minister Shehbaz Sharif said leaders ... [8679 chars]",
            "url": "https://apnews.com/article/iran-us-israel-war-oil-deal-june-17-2026-19652f4611b704c0a991bf1f5bc9a4b9",
            "image": "https://dims.apnews.com/dims4/default/dad9f59/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F8d%2Fef%2F436c8a0225c90368147a336a802d%2Fdabb1dc8c6364c7b80272bf314172500",
            "publishedAt": "2026-06-17T23:21:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "756feff940064693ad2ef65d99ab4031",
            "title": "The 5 passages of the US-Iran peace deal that worry critics the most",
            "description": "Some observers pointed to vague language involving Lebanon, Iranian assets, the Strait of Hormuz and future US policy toward Iran.",
            "content": "Five passages of the 14-point memorandum of understanding that was released Wednesday are giving critics particular concern because they leave so much room open for negotiation and interpretation.\nThe agreement, which President Trump signed on Wednes... [7517 chars]",
            "url": "https://nypost.com/2026/06/17/world-news/the-5-passages-of-the-us-iran-peace-deal-that-worry-critics-the-most/",
            "image": "https://nypost.com/wp-content/uploads/sites/2/2026/06/131295457.jpg?quality=75&strip=all&w=1200",
            "publishedAt": "2026-06-17T23:05:00Z",
            "lang": "en",
            "source": {
                "id": "9d7e5ab9f28d430ac851e2b94640216c",
                "name": "New York Post",
                "url": "https://nypost.com"
            }
        },
        {
            "id": "ec92bc8f9f973ca19f72413b5432e5c7",
            "title": "England almost guaranteed World Cup knockout place after Bellingham helps beat Croatia",
            "description": "Analysis of England's opening World Cup game against Croatia in AT&T Stadium in Dallas",
            "content": "England are almost guaranteed to reach the World Cup knockout rounds after a thrilling and at times chaotic win over Croatia in Dallas sent them top of Group L.\nThe first half of England’s campaign brought four goals, with Harry Kane scoring a retake... [12689 chars]",
            "url": "https://www.nytimes.com/athletic/7365779/2026/06/17/england-world-cup-croatia-bellingham/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/06/17174526/GettyImages-2282103009-scaled-e1781732752684.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-06-17T22:47:26Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories