United States Nation News API

Get the live top nation 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 nation 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=nation&country=us&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --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": "nation", "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: "nation",
    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" => "nation",
    "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=nation&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": 652920,
    "articles": [
        {
            "id": "aa66c3045dbc00b60a82a8cc1ddfc720",
            "title": "Melat Kiros becomes the first Gen Z woman elected to Congress",
            "description": "The 29-year-old Ethiopian immigrant was one of several candidates to win with backing from the Democratic Socialists of America or its local chapters.",
            "content": "Midterms coverage: Live results | What to know | Stories around the country\nStay connected: NPR Politics Podcast | NPR Politics newsletter | NPR app\nDemocratic socialist Melat Kiros has won the race to represent Colorado's 1st Congressional District ... [2225 chars]",
            "url": "https://www.npr.org/2026/11/03/g-s1-150229/melat-kiros-first-gen-z-woman-elected-to-congress",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/4200x2363+0+219/resize/1400/quality/85/format/webp/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F0c%2Fc2%2F22c184af4bdba31186bced5797ce%2Fgettyimages-2284382920.jpg",
            "publishedAt": "2026-11-04T02:34:21Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "a4b2e653e6cc474c4a97fb862c83e378",
            "title": "Democrats flip North Carolina's 11th District after Chuck Edwards abandoned reelection bid",
            "description": "In September, the House censured GOP Rep. Chuck Edwards over \"inappropriate conduct\" toward aides.",
            "content": "Washington — Democrat Jamie Ager flipped control of North Carolina's 11th Congressional District, CBS News projected, marking the first time a Democrat has won the seat since 2010.\nAger, a fourth-generation farmer, was initially supposed to face GOP ... [842 chars]",
            "url": "https://www.cbsnews.com/news/north-carolina-11th-district-results-jennifer-balkcom-jamie-ager/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/11/03/75fc4ed7-960f-4f32-8686-b2fe62ea189d/thumbnail/1200x630/b66182485b50bac376926146aca34ca6/gettyimages-2302440135.jpg",
            "publishedAt": "2026-11-04T02:05:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "f3ab1faac61d0ed2bc53015da9df2287",
            "title": "Republican Ashley Moody defeats progressive Angie Nixon in Florida Senate race",
            "description": "Moody is elected over Nixon in a contest seen as a measure of whether the state remains reliably Republican",
            "content": "Ashley Moody fended off a challenge from Angie Nixon, a democratic socialist, to win Florida’s special election and retain her seat in the US Senate.\nIt was the first election win for the Republican, who was appointed by Florida’s governor Ron DeSant... [1590 chars]",
            "url": "https://www.theguardian.com/us-news/2026/nov/03/ashley-moody-wins-florida-senate-race",
            "image": "https://i.guim.co.uk/img/media/ae004033dfd56bf1055b749d65ddb5db89611bee/5_0_2849_2280/master/2849.png?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=53fd5695ee7d5c7fd2a152bee1dfb750",
            "publishedAt": "2026-11-04T01:52:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

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

United States Nation News API

Categories

Request and live response