Portugal Nation News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=pt" \
  --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": "pt", "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: "pt",
    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"  => "pt",
    "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=pt&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": 206210,
    "articles": [
        {
            "id": "66cbb7cb41cdbbe7db4d2aef59babf67",
            "title": "Barómetro Intercampus: Chega cola-se ao PS na frente enquanto a AD marca passo",
            "description": "Há um empate técnico a três com os socialistas a liderarem as intenções de voto. André Ventura melhora avaliação aos olhos dos inquiridos e quase empata com José Luís Carneiro.",
            "content": "O Correio da Manhã incentiva todos os Leitores a interagirem através de comentários às notícias publicadas no seu site, de uma maneira respeitadora com o cumprimento dos princípios legais e constitucionais. Assim são totalmente ilegítimos comentários... [7369 chars]",
            "url": "https://www.cmjornal.pt/politica/detalhe/barometro-intercampus-chega-cola-se-ao-ps-na-frente-enquanto-a-ad-marca-passo",
            "image": "https://cdn.cmjornal.pt/images/2026-07/img_1280x721uu2026-07-29-21-57-23-2299985.jpg",
            "publishedAt": "2026-10-14T21:00:57Z",
            "lang": "pt",
            "source": {
                "id": "2008508df4347bc5a804914c0f2c0bf9",
                "name": "Correio da Manhã",
                "url": "https://www.cmjornal.pt"
            }
        },
        {
            "id": "3fccc9eac0c384376a748b0e3ae8a8b1",
            "title": "Manifestantes pela habitação no Porto vão montar tendas",
            "description": "Manifestantes concentrados na Praça D. João I vão voltar a montar tendas esta noite para continuar protesto contra crise na habitação.",
            "content": "Em declarações após a manifestação, seguida de assembleia popular, que reuniu mais de 500 pessoas naquela praça da baixa portuense, Pedro Manuel revelou que a vontade das pessoas, ditada por braço no ar, \"foi que continuassem o protesto [contra a cri... [2538 chars]",
            "url": "https://www.jn.pt/pais/artigo/manifestantes-pela-habitacao-no-porto-vao-montar-tendas-para-continuar-protesto/18137206",
            "image": "https://staticx.noticiasilimitadas.pt/jn/c7b6d1e7-3d0d-4b8f-a4ca-dadd093735d2_1200x675.jpg",
            "publishedAt": "2026-10-14T20:54:00Z",
            "lang": "pt",
            "source": {
                "id": "3a83ffb3c955fd3ca19ff33b144eeed1",
                "name": "Jornal de Notícias",
                "url": "https://www.jn.pt"
            }
        },
        {
            "id": "f188234fb879a4b4216c9d68bb0dd79a",
            "title": "Dois feridos após incêndio num prédio em frente à Casa de Saúde da Boavista no Porto",
            "description": "Um incêndio deflagrou, esta quarta-feira à noite, num prédio na Rua de Pedro Hispano, em frente à Casa de Saúde da Boavista, no Porto, provocando dois feridos por inalação de fumo. O prédio foi evacuado por precaução.",
            "content": "Em declarações ao JN, Luciano Martins, sub-chefe dos Bombeiros Sapadores do Porto, avançou que o fogo deixou duas pessoas feridas, ambas por inalação de fumo. O prédio foi evacuado e foram retirados cerca de 20 moradores. Não se sabe ainda se haverá ... [356 chars]",
            "url": "https://www.jn.pt/pais/artigo/bombeiros-combatem-chamas-num-predio-em-frente-a-casa-de-saude-da-boavista-no-porto/18137176",
            "image": "https://staticx.noticiasilimitadas.pt/jn/8eb7eaa9-18d1-4c1c-865e-c72164926d8a_1200x675.jpg",
            "publishedAt": "2026-10-14T19:05:00Z",
            "lang": "pt",
            "source": {
                "id": "3a83ffb3c955fd3ca19ff33b144eeed1",
                "name": "Jornal de Notícias",
                "url": "https://www.jn.pt"
            }
        }
    ]
}

Missing a publisher from Portugal? Suggest a source.

Portugal Nation News API

Categories

Request and live response