Portugal World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 164592,
    "articles": [
        {
            "id": "225dcc798a553be3b76da2334155fa27",
            "title": "Eleições intercalares chamam 200 milhões às urnas nos Estados Unidos",
            "description": "Os norte-americanos estão a escolher os novos representantes no Congresso. Está em causa o controlo das duas câmaras e a capacidade do presidente norte-americano de manter a sua agenda política numa altura em que os índices de aprovação de Donald Trump são dos mais baixos de sempre.",
            "content": "Na escola intermédia de Salina, em Dearborn, às portas da cidade industrial junto da fronteira canadiana, a delegada eleitoral Amy Jones anda num virote. São precisas mesas para os voluntários, é preciso que todos conheçam as regras e há eleitores qu... [8886 chars]",
            "url": "https://www.rtp.pt/noticias/mundo/eleicoes-intercalares-chamam-200-milhoes-as-urnas-nos-estados-unidos_e1776677",
            "image": "https://cdn-images.rtp.pt/icm/noticias/images/94/94e5ee02b3a184431a91e42cd928929e?w=860&q=90&rect=0,33,1500,822&auto=format",
            "publishedAt": "2026-11-03T23:48:33Z",
            "lang": "pt",
            "source": {
                "id": "7e859acc1e9a3d808232e77a162e654d",
                "name": "RTP",
                "url": "https://www.rtp.pt"
            }
        },
        {
            "id": "c724cb72194187cce1a78bf7542947c8",
            "title": "Impacto decisivo no mandato de Trump e no equilíbrio legislativo",
            "description": "Acompanhe as eleições intercalares nos EUA, onde milhões de eleitores decidem o futuro político de Trump e o equilíbrio legislativo de Washington. Saiba como o resultado pode impactar temas como economia, imigração e política externa.",
            "content": "O senador democrata Jon Ossoff foi projetado vencedor na corrida ao Senado pelo estado da Geórgia, segundo as projeções da cadeia norte-americana NBC.\nEsta vitória é o primeiro resultado confirmado num battleground state (estado oscilante) nestas ele... [8279 chars]",
            "url": "https://www.dn.pt/internacional/eleies-intercalares-nos-eua-ao-minuto-escrutnio-decisivo-para-o-mandato-de-trump",
            "image": "https://media.assettype.com/dn%2F2026-11-04%2Fqnzkt9fu%2FDOC.20261103.48061784.13351430.jpg?w=1200&ar=40%3A21&auto=format%2Ccompress&ogImage=true&mode=crop&enlarge=true&overlay=false&overlay_position=bottom&overlay_width=100",
            "publishedAt": "2026-11-03T21:46:57Z",
            "lang": "pt",
            "source": {
                "id": "db40f5e9cd1bd4b2514c9d7e882040dd",
                "name": "Diário de Notícias",
                "url": "https://www.dn.pt"
            }
        },
        {
            "id": "19b8e8a9c6dc4bdba045b129e935a8c2",
            "title": "Montenegro chama líderes do PS e do Chega para falar sobre a crise na habitação",
            "description": "O primeiro-ministro, Luís Montenegro, reúne-se, esta quinta-feira, com José Luís Carneiro e André Ventura em São Bento.",
            "content": "O convite a José Luís Carneiro, secretário-geral do PS, e André Ventura, presidente do Chega, foi deixado na comunicação ao país desta terça-feira e do encontro deverá sair uma decisão relativamente ao problema da habitação, que nas últimas semanas t... [1461 chars]",
            "url": "https://www.rtp.pt/noticias/pais/montenegro-chama-lideres-do-ps-e-do-chega-para-falar-sobre-a-crise-na-habitacao_n1776649",
            "image": "https://cdn-images.rtp.pt/icm/noticias/images/03/030b69bbe3e1ce470c0944f604b0fe33?w=860&q=90&rect=0,56,1500,822&auto=format",
            "publishedAt": "2026-11-03T20:11:49Z",
            "lang": "pt",
            "source": {
                "id": "7e859acc1e9a3d808232e77a162e654d",
                "name": "RTP",
                "url": "https://www.rtp.pt"
            }
        }
    ]
}

Missing a source from Portugal? Suggest a source.

Portugal World News API

Categories

Request and live response