Portugal Nation News API

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

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"  => "pt",
    "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=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": 207568,
    "articles": [
        {
            "id": "9c998a01b9255d9c9be03aacb8714589",
            "title": "Homem morre em colisão entre carro e mota em Sintra",
            "description": "Alerta foi dado pelas 22h39. Vítima era o motociclista.",
            "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/portugal/detalhe/uma-vitima-mortal-em-colisao-entre-carro-e-mota-em-sintra",
            "image": "https://cdn.cmjornal.pt/images/2026-09/img_1280x721uu2026-09-27-09-31-00-2310887.png",
            "publishedAt": "2026-11-03T22:58:00Z",
            "lang": "pt",
            "source": {
                "id": "2008508df4347bc5a804914c0f2c0bf9",
                "name": "Correio da Manhã",
                "url": "https://www.cmjornal.pt"
            }
        },
        {
            "id": "1f261ea66f4aa515d37356bd3b231025",
            "title": "Habitação. José Luís Carneiro saúda decisão do Governo e diz-se disposto a partilhar propostas",
            "description": "Em reação às declarações de Luís Montenegro, o secretário-geral do Partido Socialista garantiu que vai colaborar com o Governo na resolução de um problema que considera ser \"político\".",
            "content": "“O partido Socialista, estando na oposição, é a alternativa de Governo”, considerou José Luís Carneiro, recordando que o PS foi o primeiro partido a colocar em causa a nova lei das rendas proposta pelo Governo.\nO líder do PS considerou que \"o primeir... [899 chars]",
            "url": "https://www.rtp.pt/noticias/economia/habitacao-jose-luis-carneiro-sauda-decisao-do-governo-e-diz-se-disposto-a-partilhar-propostas_n1776656",
            "image": "https://cdn-images.rtp.pt/icm/noticias/images/4f/4f5efc8a61d6ba14adea35990748fb0b?w=860&q=90&rect=0,11,1500,822&auto=format",
            "publishedAt": "2026-11-03T21:35:44Z",
            "lang": "pt",
            "source": {
                "id": "7e859acc1e9a3d808232e77a162e654d",
                "name": "RTP",
                "url": "https://www.rtp.pt"
            }
        },
        {
            "id": "810a12343cd5c26d6b37a2a3af1432d8",
            "title": "Aguaceiro no Pico Alto atingiu valores de aviso laranja",
            "description": "23,5 litros numa hora e 13,2 litros em apenas dez minutos",
            "content": "Uma forte precipitação atingiu esta tarde a zona do Pico Alto, entre o Monte e o Areeiro, onde a estação meteorológica registou valores que correspondem a aviso laranja.\nDe acordo com os dados do IPMA, foram acumulados 23,5 mm (litros por metro quadr... [509 chars]",
            "url": "https://www.dnoticias.pt/2026/11/3/511508-aguaceiro-no-pico-alto-atingiu-valores-de-aviso-laranja/",
            "image": "https://static-storage.dnoticias.pt/www-assets/images/configuration/fb-9/logocgua.JPEG",
            "publishedAt": "2026-11-03T20:37:00Z",
            "lang": "pt",
            "source": {
                "id": "1b80a3473f15458f0cdbf22db94ad974",
                "name": "dnoticias.pt",
                "url": "https://www.dnoticias.pt"
            }
        }
    ]
}

Missing a source from Portugal? Suggest a source.

Portugal Nation News API

Categories

Request and live response