United States News API

Get the live top headlines from the United States with one request to the Top Headlines endpoint of GNews API. Headlines are based on Google News rankings and returned as JSON.

Get API key

Request and live response

This request returns the current top headlines from the United States. The response below is live: it was fetched when this page loaded. Every parameter is described in the Top Headlines endpoint documentation.

GET https://gnews.io/api/v4/top-headlines?category=general&country=us&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=us" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/top-headlines",
    params={"category": "general", "country": "us", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    category: "general",
    country: "us",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/top-headlines?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

On the Free plan, browsers can only call the API from localhost: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

$params = http_build_query([
    "category" => "general",
    "country"  => "us",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $params);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/top-headlines?category=general&country=us&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

200 OK · Live JSON response

{
    "totalArticles": 646682,
    "articles": [
        {
            "id": "946852caf7307c6e745b285fe817b724",
            "title": "Democrats win control of the House and vow to keep Trump in check",
            "description": "NBC News projects that Democrats will take control of the House next year, giving them the power to investigate Trump and advance legislation to check his policies.",
            "content": "Democrats won control of the House of Representatives with what could be their largest majority in nearly two decades, NBC News projects, as voters delivered a stunning rebuke to President Donald Trump and Republicans.\nThe House projection is based o... [7930 chars]",
            "url": "https://www.nbcnews.com/politics/2026-election/democrats-house-control-midterm-election-wins-trump-check-rcna603397",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-11/261102-democratic-house-control-capitol-cs-0bbdf2.jpg",
            "publishedAt": "2026-11-04T08:43:40Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "020da3b2d80801863b4e890f01e95072",
            "title": "Democrat Abdul El-Sayed wins Michigan’s high-stakes Senate race",
            "description": "Abdul El-Sayed, an epidemiologist and former public health official aligned with the Democratic Party’s left flank, has won Michigan’s highly hostile Senate race, defeating his Republican rival, former Rep.",
            "content": "Abdul El-Sayed, an epidemiologist and former public health official aligned with the Democratic Party’s left flank, has won Michigan’s highly hostile Senate race, defeating his Republican rival, former Rep. Mike Rogers, NBC News projects.\nEl-Sayed, 4... [4491 chars]",
            "url": "https://www.nbcnews.com/politics/2026-election/democrat-abdul-el-sayed-wins-michigans-high-stakes-senate-race-rcna603315",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-10/261021-Abdul-El-Sayed-michigan-senate-midterm-vsb-1c83db.jpg",
            "publishedAt": "2026-11-04T07:26:00Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "868913bc6b8b38ae4b04b1ca4e4d4f90",
            "title": "Texas election results: Hinojosa beats Abbott, Talarico wins",
            "description": "Texas election results live: Hinojosa defeats Abbott, Talarico wins the U.S. Senate race and Democrats flip the House. Follow the latest updates.",
            "content": "Votes continue to be counted across Texas in the 2026 midterm elections, with Democrats securing major victories in the races for governor, U.S. Senate and control of both chambers of Congress.\nDemocrat Gina Hinojosa has defeated Republican Gov. Greg... [1353 chars]",
            "url": "https://www.nbcdfw.com/news/politics/lone-star-politics/dallas-north-texas-election-results-2026/4098642/",
            "image": "https://media.nbcdfw.com/2026/11/split-2-diagonal-1200x675-8.jpg?quality=85&strip=all&resize=1200%2C675",
            "publishedAt": "2026-11-04T07:13:03Z",
            "lang": "en",
            "source": {
                "id": "2e39d160aaa84ea369b07423907219ab",
                "name": "NBC 5 Dallas-Fort Worth",
                "url": "https://www.nbcdfw.com"
            }
        }
    ]
}

Missing a source from the United States? Suggest a source.

United States News API

Categories

Request and live response