Spain Nation News API

Get the live top nation headlines from Spain 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 nation headlines from Spain. 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=es&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=es" \
  --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": "es", "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: "es",
    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" => "nation",
    "country"  => "es",
    "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=nation&country=es&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": 223916,
    "articles": [
        {
            "id": "983217031e3109e0545032198fc585e6",
            "title": "L’arribada d’una dana amenaça de provocar noves pluges",
            "description": "Després d’un canvi de temps brusc, les precipitacions poden ser torrencials al Mediterrani a partir d’aquest cap de setmana.",
            "content": "Notícies relacionades\nL’Agència Estatal de Meteorologia (Aemet) va emetre ahir una nota especial informativa alertant sobre l’arribada d’aquests fenòmens a Espanya. Segons indiquen les últimes projeccions, tot apunta que a partir de dissabte podríem ... [1059 chars]",
            "url": "https://www.elperiodico.cat/societat/20261015/l-arribada-d-dana-amenaca-135349437",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/f637283d-96f8-4d98-ace0-03a4107536dc_16-9-aspect-ratio_default_0.jpg",
            "publishedAt": "2026-10-15T00:36:44Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        },
        {
            "id": "98a4c99b917fdab90ca6a7d34a608faf",
            "title": "El PSC continua anant a la baixa, seguit d’Aliança Catalana i ERC, segons el CEO",
            "description": "El Centre d’Estudis d’Opinió (CEO) de la Generalitat va posar ahir el termòmetre a la política catalana amb la seva segona enquesta de l’any sobre les eleccions autonòmiques. El baròmetre manté les diferències de l’anterior, amb el PSC al capdavant però acusant més desgast, i amb ERC i Aliança Catalana disputant-se la segona plaça. El partit ultra independentista no aconsegueix...",
            "content": "Salvador Illa tornaria a guanyar les eleccions amb el 21,5% dels vots i una forquilla de 33-35 escons (ara en té 42), sis punts i mig menys que el 2024. ERC manté les seves expectatives de recuperació i aconseguiria el 17,2% dels sufragis i 24-26 dip... [1248 chars]",
            "url": "https://www.elperiodico.cat/politica/20261015/psc-continua-anant-baixa-seguit-135349069",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/c9ee64ca-cf94-4a05-8f2a-ae3f3ed81d71_16-9-aspect-ratio_default_0.jpg",
            "publishedAt": "2026-10-14T23:15:24Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        },
        {
            "id": "e8b5afc900977afbe0c747bedd17492e",
            "title": "El Rei s’acomiada de Ceuta i Melilla i demana més \"proximitat\" d’Espanya",
            "description": "Felip VI tanca a Melilla un viatge d’alt voltatge polític amb missatges al Marroc, la Unió Europea i una petició d’\"unitat institucional\"",
            "content": "El cap d’Estat va aprofitar la seva presència a les dues ciutats autònomes per reivindicar la sobirania espanyola, reclamar \"bona fe\" al país veí, recordar a Europa les seves responsabilitats en la protecció de les fronteres i demanar \"unitat institu... [3266 chars]",
            "url": "https://www.elperiodico.cat/politica/20261015/rei-s-acomiada-ceuta-melilla-135348399",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/be27dbf0-8d3b-47dd-92dd-4605f49cde2e_16-9-aspect-ratio_default_0_x358y267.jpg",
            "publishedAt": "2026-10-14T22:19:45Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        }
    ]
}

Missing a publisher from Spain? Suggest a source.

Spain Nation News API

Categories

Request and live response