Brazil World News API

Get the live top world headlines from Brazil 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 Brazil. 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=br&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=br" \
  --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": "br", "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: "br",
    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"  => "br",
    "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=br&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": 270646,
    "articles": [
        {
            "id": "c2d707368b674b31bf05f224d1ff7739",
            "title": "Chris Pappas é o 1º homem gay eleito para o Senado dos EUA",
            "description": "Democrata venceu a disputa em New Hampshire, que era considerada estratégica para definir o equilíbrio de forças no Senado americano; republicano John Sununu reconheceu a derrota.",
            "content": "O resultado foi confirmado na noite desta terça-feira (3), quando o republicano John Sununu reconheceu a derrota. Segundo Sununu, ele telefonou para Pappas para admitir o resultado da eleição.\nAos 46 anos, Pappas atualmente representa o 1º distrito c... [1822 chars]",
            "url": "https://g1.globo.com/mundo/noticia/2026/11/03/chris-pappas-se-torna-primeiro-homem-abertamente-gay-eleito-para-o-senado-dos-eua.ghtml",
            "image": "https://s2-g1.glbimg.com/AcOeyfW9qE8KVEpfkSx7Nq0S5B0=/3896x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_59edd422c0c84a879bd37670ae4f538a/internal_photos/bs/2026/A/p/YvETFWRZuGdQ5V7L4isw/ap26302073876199.jpg",
            "publishedAt": "2026-11-04T02:07:34Z",
            "lang": "pt",
            "source": {
                "id": "776b9efe5cc2aef8ea8147e620e89dbb",
                "name": "G1",
                "url": "https://g1.globo.com"
            }
        },
        {
            "id": "61ee67379d5e68121619caf60a782ae0",
            "title": "Ashley Moody vence disputa para o Senado na Flórida",
            "description": "Ashley Moody, que assumiu a vaga de Marco Rubio, venceu a democrata Angie Nixon em disputa acirrada, mantendo a Flórida como um reduto republicano no Senado.",
            "content": "Durante quase toda a apuração de votos, Nixon aparecia um pouco à frente de Moody. A republicana tomou a liderança antes do fim da apuração de todos os votos.\nMoody, apesar de incumbente, foi indicada para a vaga em 2025 pelo Partido Republicano após... [1292 chars]",
            "url": "https://g1.globo.com/mundo/noticia/2026/11/03/candidata-republicana-vence-disputa-acirrada-para-o-senado-na-florida.ghtml",
            "image": "https://s2-g1.glbimg.com/pKpdMfaieU4BQN-UFFI4PuGQya4=/1280x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_59edd422c0c84a879bd37670ae4f538a/internal_photos/bs/2026/9/V/4nQKR0RKaA3gL18yyK5Q/montagem-horizontal-1280x720px-3-.jpg",
            "publishedAt": "2026-11-04T01:36:09Z",
            "lang": "pt",
            "source": {
                "id": "776b9efe5cc2aef8ea8147e620e89dbb",
                "name": "G1",
                "url": "https://g1.globo.com"
            }
        },
        {
            "id": "75134eb07412c94dd6e76e5daad8075f",
            "title": "Alasca pode protagonizar uma das maiores derrotas de Donald Trump nas eleições",
            "description": "Já o Texas, a principal base eleitoral do Partido Republicano e, por isso mesmo, é um dos mais importantes alvos para o Partido Democrata nessa eleição.",
            "content": "\"Está animado por aqui. Olha, se em 2024 os republicanos conseguiram construir uma muralha vermelha de votos para eleger Donald Trump em vários estados, a fortaleza dessa muralha era o estado do Texas. Só que essa fortaleza republicana agora, nessas ... [1764 chars]",
            "url": "https://g1.globo.com/jornal-nacional/noticia/2026/11/03/alasca-pode-protagonizar-uma-das-maiores-derrotas-de-donald-trump-nas-eleicoes.ghtml",
            "image": "https://s2-g1.glbimg.com/ZXeabSO22FpiiLZr-csBL5yQuEk=/3840x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_59edd422c0c84a879bd37670ae4f538a/internal_photos/bs/2026/2/K/7Orj8xSaAsseepXCRhjw/globo-canal-4-20261103-2000-frame-73629.jpeg",
            "publishedAt": "2026-11-04T00:19:04Z",
            "lang": "pt",
            "source": {
                "id": "776b9efe5cc2aef8ea8147e620e89dbb",
                "name": "G1",
                "url": "https://g1.globo.com"
            }
        }
    ]
}

Missing a source from Brazil? Suggest a source.

Brazil World News API

Categories

Request and live response