Portugal News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 296010,
    "articles": [
        {
            "id": "7beb841bacf0fe7ee296ac93148c6b8f",
            "title": "Benfica vence na Luz para a Taça Europa",
            "description": "Equipa de basquetebol das águias derrotou o Denizli, por 96-91, na segunda jornada da fase regular da prova Continue a ler.",
            "content": "Equipa de basquetebol das águias derrotou o Denizli, por 96-91, na segunda jornada da fase regular da prova\nO Benfica derrotou os turcos do Denizli, por 96-91, pleno de vitórias disputadas duas jornadas no Grupo G da Taça Europa — 91-81 em casa na ro... [314 chars]",
            "url": "https://www.abola.pt/noticias/benfica-vence-na-luz-para-a-taca-europa-2026101421295043997",
            "image": "https://sportal365images.com/process/smp-images-production/abola.pt/14102026/b590791b-8e1a-4103-b263-10f1fae911e2.jpg?operations=crop(0:570:5470:3646),autocrop(1200:630)",
            "publishedAt": "2026-10-14T21:29:00Z",
            "lang": "pt",
            "source": {
                "id": "bbfb9653500b3a49438fad20619c9017",
                "name": "A Bola",
                "url": "https://www.abola.pt"
            }
        },
        {
            "id": "21adcac4f49fd0272d2420a721face6d",
            "title": "'Remontada' histórica do Real Madrid em Roma",
            "description": "Quando a Roma parecia ter o jogo ganha a ganhar por 3-1, a equipa de José Mourinho começou ao minuto 83 a recuperação, com Bernardo Silva em campo e Arda Guler e Endrick em destaque Continue a ler.",
            "content": "Uma história antiga que voltou a ser vivida na cidade eterna. O Real Madrid parecia morto, fora do jogo, condenado à derrota. Mas Espí, amuleto de José Mourinho entrou e marcou. Endrick deu a volta a encontro por completo. Arda Guler espalhou talento... [1771 chars]",
            "url": "https://www.abola.pt/noticias/remontada-historica-do-real-madrid-em-roma-2026101421155426459",
            "image": "https://sportal365images.com/process/smp-images-production/abola.pt/14102026/37bd342b-9078-482f-ba3c-f2576261d0a3.jpg?operations=autocrop(1200:630)",
            "publishedAt": "2026-10-14T21:15:00Z",
            "lang": "pt",
            "source": {
                "id": "bbfb9653500b3a49438fad20619c9017",
                "name": "A Bola",
                "url": "https://www.abola.pt"
            }
        },
        {
            "id": "8b6f5f99e33cc6dc61ae57c0dace60db",
            "title": "DGS confirma três casos de sarampo na região de Lisboa e Vale do Tejo",
            "description": "Não há evidência de que os casos estejam relacionados entre si.",
            "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/sociedade/detalhe/dgs-confirma-tres-casos-de-sarampo-na-regiao-de-lisboa-e-vale-do-tejo",
            "image": "https://cdn.cmjornal.pt/images/2026-04/img_1280x721uu2026-04-09-14-08-20-2277498.jpg",
            "publishedAt": "2026-10-14T21:03:59Z",
            "lang": "pt",
            "source": {
                "id": "2008508df4347bc5a804914c0f2c0bf9",
                "name": "Correio da Manhã",
                "url": "https://www.cmjornal.pt"
            }
        }
    ]
}

Missing a publisher from Portugal? Suggest a source.

Portugal News API

Categories

Request and live response