Spain Nation News API

Get the live top nation headlines from Spain 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 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);
}

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"  => "es",
    "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=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": 231350,
    "articles": [
        {
            "id": "d064670d5160a294c69a1da9649bbda7",
            "title": "Las palabras de Óscar Puente sobre los controladores que el sindicato Alferro ve constitutivas de delito y ha llevado ante la Fiscalía del Tribunal Supremo",
            "description": "Fue su primera comparecencia pública tras el accidente en Urda (Toledo) y lo hizo desde el centro de control que Adif tiene en la estación madrileña de Atocha. Eran momentos de...",
            "content": "Fue su primera comparecencia pública tras el accidente en Urda (Toledo) y lo hizo desde el centro de control que Adif tiene en la estación madrileña de Atocha. Eran momentos de muchas dudas y gran tensión y el dimitido ministro Óscar Puente atendió a... [3369 chars]",
            "url": "https://www.elmundo.es/economia/2026/11/04/6aea3b20e9cf4a3b328b45ac.html",
            "image": "https://e01-phantom-elmundo.uecdn.es/6eeabcb42f684adf93484c874aa04249/resize/1200/f/webp/assets/multimedia/imagenes/2026/11/03/17937391312426.jpg",
            "publishedAt": "2026-11-03T23:10:00Z",
            "lang": "es",
            "source": {
                "id": "b0ce8104ba9d892b3581af2e111e61b6",
                "name": "El Mundo",
                "url": "https://www.elmundo.es"
            }
        },
        {
            "id": "4421bdbfb47d20d02158c4443c0fcb8e",
            "title": "Óscar Puente fa un gir de guió i dimiteix: \"És una qüestió de dignitat política, coherència i empatia amb les víctimes\"",
            "description": "El dirigent comunica la seva sortida del Ministeri de Transports i de les llistes del PSOE, assumint en primera persona la responsabilitat política derivada dels dos accidents ocorreguts",
            "content": "El ministre de Transports, Óscar Puente, ha anunciat la seva dimissió \"per dignitat política\" arran de l'accident d'Urda. \"Un ministre de Transports no pot continuar en el càrrec amb dos accidents d'aquesta gravetat en menys d'un any, per molt difere... [3787 chars]",
            "url": "https://www.emporda.info/internacional/2026/11/03/oscar-puente-dimiteix-gir-guio-136059500.html",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/432bc875-9ca3-4257-ba6a-ca6fdcec562a_16-9-discover-aspect-ratio_default_0_x1000y417.jpg",
            "publishedAt": "2026-11-03T22:00:14Z",
            "lang": "ca",
            "source": {
                "id": "36229987ad2ff9a52138ca6d0198afc4",
                "name": "EMPORDÀ",
                "url": "https://www.emporda.info"
            }
        },
        {
            "id": "fe53f99b9828ccbd9353e7d6b23fd4a1",
            "title": "Óscar Puente dimite como ministro de Transportes tras la tragedia de Urda",
            "description": "Ha anunciado su renuncia justo al acabar una comparecencia de cuatro horas en la Diputación Permanente del Congreso, para rendir cuentas por el siniestro ferroviario de Toledo, con 69 muertes",
            "content": "Óscar Puente ha anunciado su dimisión como ministro de Transportes tras su comparecencia este martes en la Diputación Permanente del Congreso, en la que ha defendido la inversión en el ADIF tras «años de profunda desinversión y baja ejecución» y ha v... [4537 chars]",
            "url": "https://www.lavozdegalicia.es/noticia/espana/2026/11/03/oscar-puente-dimite-ministro-transportes/00031793736767788462389.htm",
            "image": "https://img.lavdg.com/sc/8UTrrHMNMNTHI-WiQKe1ZWwikYY=/1280x/2026/11/03/00121793736483245402603/Foto/efe_20261103_174413584.jpg",
            "publishedAt": "2026-11-03T21:48:26Z",
            "lang": "es",
            "source": {
                "id": "7cab412f1ae102bfe9f2d1074728c5d6",
                "name": "La Voz de Galicia",
                "url": "https://www.lavozdegalicia.es"
            }
        }
    ]
}

Missing a source from Spain? Suggest a source.

Spain Nation News API

Categories

Request and live response