Portugal World News API

Get the live top world 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 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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "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=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": 157632,
    "articles": [
        {
            "id": "a2286aeead07c0dc75212892a3adf060",
            "title": "Juiz convoca Maduro e Flores a tribunal para responder a novas acusações",
            "description": "O juiz norte-americano Alvin Hellerstein marcou para quinta-feira uma audiência em Nova Iorque para o presidente venezuelano deposto, Nicolás Maduro, e a mulher, Cilia Flores, responderem às novas acusações de conspiração para cometer tortura.",
            "content": "O juiz norte-americano Alvin Hellerstein marcou para quinta-feira uma audiência em Nova Iorque para o presidente venezuelano deposto, Nicolás Maduro, e a mulher, Cilia Flores, responderem às novas acusações de conspiração para cometer tortura.\nAs nov... [1913 chars]",
            "url": "https://sapo.pt/artigo/juiz-convoca-maduro-e-flores-a-tribunal-para-responder-a-novas-acusacoes-6acfe99e71bdbe0b748f030f",
            "image": "https://static-storage.dnoticias.pt/www-assets.dnoticias.pt/images/configuration/MD/DOC.20260103.46284956.12622983_iM9jsbt_3TzLQei.JPEG",
            "publishedAt": "2026-10-14T20:42:18Z",
            "lang": "pt",
            "source": {
                "id": "fb52602e439b17e018d565bc8be029d1",
                "name": "SAPO",
                "url": "https://sapo.pt"
            }
        },
        {
            "id": "11074caf734e5744a4ac8fb7a721d534",
            "title": "Juiz estende bloqueio à probição de Trump sobre CNN, MS NOW e Politico",
            "description": "Presidente norte-americano vetou o acesso das duas televisões e do jornal à Casa Branca. Meios de comunicação retaliaram com um processo legal.",
            "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/mundo/detalhe/juiz-estende-bloqueio-a-probicao-de-trump-sobre-cnn-ms-now-e-politico",
            "image": "https://cdn.cmjornal.pt/images/2026-10/img_1280x721uu2026-10-10-07-43-35-2312018.jpg",
            "publishedAt": "2026-10-14T19:51:03Z",
            "lang": "pt",
            "source": {
                "id": "2008508df4347bc5a804914c0f2c0bf9",
                "name": "Correio da Manhã",
                "url": "https://www.cmjornal.pt"
            }
        },
        {
            "id": "3b21376528a26af081ce66a4f0373343",
            "title": "Faber retira livros de Sally Rooney do mercado britânico",
            "description": "Editora britânica Faber deixa de comercializar obras de Sally Rooney no Reino Unido devido a legislação sobre Palestine Action.",
            "content": "A Faber, responsável pela publicação das obras de Sally Rooney, anunciou que \"deixará de disponibilizar os seus livros no Reino Unido, em qualquer formato\", na sequência da legislação aprovada pelo Governo britânico relativa ao grupo Palestine Action... [2869 chars]",
            "url": "https://www.jn.pt/mundo/artigo/editora-britanica-retira-livros-de-sally-rooney-do-mercado-por-apoio-a-grupo-pro-palestiniano/18137168",
            "image": "https://staticx.noticiasilimitadas.pt/jn/0b53728f-faac-48c4-b283-5da5615a6db8_1200x675.jpg",
            "publishedAt": "2026-10-14T18:41: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 World News API

Categories

Request and live response