United States News API

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

Get your free 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);
}

<?php

$apiKey = "YOUR_API_KEY";

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

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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": 652722,
    "articles": [
        {
            "id": "a29a7612fdc438eadcc1695cc4a3a694",
            "title": "Detienen a 237 personas durante operación contra el crimen organizado en Nuevo México",
            "description": "Durante una operación conjunta del gobierno de EEUU en Nuevo México, el HSI arrestó a 237 personas, de las cuales 12 fueron identificadas como integrantes de pandillas y se incautaron 17 armas de fuego. | N+ Univision Criminalidad | Univision",
            "content": "Durante una operación conjunta del gobierno de EEUU en Nuevo México, el HSI arrestó a 237 personas, de las cuales 12 fueron identificadas como integrantes de pandillas y fueron incautadas 17 armas de fuego.\nVideo Megaoperativo en Skid Row: desmantela... [877 chars]",
            "url": "https://www.univision.com/noticias/criminalidad/detienen-a-273-personas-durante-operacion-contra-el-crimen-organizado-en-nuevo-mexico",
            "image": "https://www.univision.com/api/image/og/us/noticias/criminalidad/detienen-a-273-personas-durante-operacion-contra-el-crimen-organizado-en-nuevo-mexico",
            "publishedAt": "2026-10-14T23:53:54Z",
            "lang": "es",
            "source": {
                "id": "eb4456d007d51d44dc62d01c16a53d83",
                "name": "Univision",
                "url": "https://www.univision.com"
            }
        },
        {
            "id": "97f721eae4dbfd3ad7eab33d774ea8fa",
            "title": "Florida man arrested on murder charge in ex-fiancée's 2011 disappearance",
            "description": "Michelle Parker disappeared the same day that an episode of \"The People's Court\" aired that featured Parker and the suspect, Dale Smith Jr., in a contentious dispute over an engagement ring.",
            "content": "A man has been arrested on a murder charge in connection with the disappearance of his ex-fiancée nearly 15 years ago, authorities in Orlando, Florida, announced Wednesday.\nMichelle Parker, then 33, disappeared on Nov. 17, 2011, the same day that an ... [1962 chars]",
            "url": "https://www.cbsnews.com/news/michelle-parker-fiancee-orlando-florida-arrest-murder-charge-2011-disappearance-peoples-court/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/10/14/9e63754b-b47b-45b1-b255-ebb3e0acc9ef/thumbnail/1200x630/b9b49008fc5af5349e7248d54a61b756/arrest.jpg",
            "publishedAt": "2026-10-14T22:51:12Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "cc23f7139281cc62dce679d3d8f7cff2",
            "title": "Ilhan Omar’s phone seized and relatives subpoenaed in criminal inquiry, source says",
            "description": "Federal authorities issued more than a dozen grand jury subpoenas in inquiry into potential immigration fraud",
            "content": "Federal authorities investigating the Minnesota representative Ilhan Omar seized the Democratic lawmaker’s phone and have issued more than a dozen grand jury subpoenas, including to some of her relatives, according to a person briefed on the inquiry.... [2452 chars]",
            "url": "https://www.theguardian.com/us-news/2026/oct/14/ilhan-omar-phone-seized-relatives-subpoenaed",
            "image": "https://i.guim.co.uk/img/media/99e0f76a722d221d9650181d03e54a5fc22b6d4b/323_0_2853_2283/master/2853.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=3f9892c92a4b06d8f3d26a4c5776a818",
            "publishedAt": "2026-10-14T22:22:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

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

United States News API

Categories

Request and live response