Brazil News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 619850,
    "articles": [
        {
            "id": "f2a9ebaeafacc6c903325bf7cf77ebba",
            "title": "Democrata Abdul El-Sayed é eleito como primeiro muçulmano ao Senado dos EUA",
            "description": "Filho de imigrantes egípcios, candidato chegou ao Senado pela ala esquerda do Partido Democrata, após uma campanha marcada por críticas ao apoio americano a Israel e ataques à sua fé muçulmana",
            "content": "O médico Abdul El-Sayed, de 42 anos, será o primeiro senador de origem árabe e muçulmano do país dos Estados Unidos. Com a vitória na disputa no estado americano do Michigan (projetada pelo jornal The New York Times e pela rede de TV CNN), os democra... [5209 chars]",
            "url": "https://oglobo.globo.com/mundo/noticia/2026/11/04/democrata-abdul-el-sayed-e-eleito-como-primeiro-arabe-muculmano-ao-senado-dos-eua.ghtml",
            "image": "https://s2-oglobo.glbimg.com/XOoGlqJPWBAQzmd8yAXjuRkKJMA=/1200x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_da025474c0c44edd99332dddb09cabe8/internal_photos/bs/2026/0/Y/8XD8H3TCeVi9XSW3KCRg/afp-20260805-c3yn9r6-v1-midres-ussenatecandidateabdulelsayedelectionnight.jpg",
            "publishedAt": "2026-11-04T07:36:44Z",
            "lang": "pt",
            "source": {
                "id": "3cf5a75bcb0bc7bec02eca895594ed0c",
                "name": "O GLOBO",
                "url": "https://oglobo.globo.com"
            }
        },
        {
            "id": "f5e0fa8993c5bda17617cee962336b52",
            "title": "São Paulo x Corinthians: onde assistir ao vivo, horário e escalações",
            "description": "Veja também desfalques, arbitragem e outras informações do clássico válido pela 34ª rodada do Brasileirão",
            "content": "São Paulo e Corinthians se enfrentam nesta quarta-feira, às 21h30 (de Brasília), na Vila Belmiro, pela 34ª rodada do Campeonato Brasileiro. Globo, Premiere e ge tv transmitem o clássico ao vivo. O ge faz a cobertura dos lances em tempo real (clique a... [4000 chars]",
            "url": "https://ge.globo.com/sp/futebol/brasileirao-serie-a/noticia/2026/11/04/sao-paulo-x-corinthians-onde-assistir-ao-vivo-horario-e-escalacoes.ghtml",
            "image": "https://s2-ge.glbimg.com/bYzYByp94NiIeH5EBy_GY5K4ROA=/1280x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_bc8228b6673f488aa253bbcb03c80ec5/internal_photos/bs/2025/2/o/fVBGMHQlWArkd4Cj3dmQ/vila-sp-inter.jpeg",
            "publishedAt": "2026-11-04T07:00:00Z",
            "lang": "pt",
            "source": {
                "id": "f5c4e65e4a9cf75c37742e93eb903b0f",
                "name": "ge",
                "url": "https://ge.globo.com"
            }
        },
        {
            "id": "4ca7e65bb1b579ca2db26ce10ce5e771",
            "title": "Eleições nos EUA: democratas conquistam maioria da Câmara e do Senado, impõem derrota a Trump e assumem controle do Congresso",
            "description": "Pelos próximos dois anos, democratas terão maioria nas duas casas, o que causará desafios ao governo do presidente americano. Trump disse que aceitaria derrota, mas postou imagem com a palavra 'veto', sinalizando como poderia governar diante da oposição fortalecida.",
            "content": "O Partido Democrata conquistou na madrugada desta quarta-feira (4) a maioria das duas casas do Congresso dos Estados Unidos. O resultado configura uma derrota histórica para o presidente republicano Donald Trump em meio às eleições legislativas de me... [5450 chars]",
            "url": "https://g1.globo.com/mundo/noticia/2026/11/04/eleicoes-nos-eua-democratas-conquistam-maioria-da-camara-e-no-senado-impoem-derrota-a-trump-e-assumem-controle-do-congresso.ghtml",
            "image": "https://s2-g1.glbimg.com/VJAXuUhN3_EShhGoIIS_hnDEoBI=/2058x0/filters:format(jpeg)/https://i.s3.glbimg.com/v1/AUTH_59edd422c0c84a879bd37670ae4f538a/internal_photos/bs/2026/7/S/hrdq0VT7G7O8cLkvqoAg/2026-11-02t201130z-1068760776-rc2vfoa9kiae-rtrmadp-3-usa-trump-lincolnmemorial.jpg",
            "publishedAt": "2026-11-04T06:24:22Z",
            "lang": "pt",
            "source": {
                "id": "776b9efe5cc2aef8ea8147e620e89dbb",
                "name": "G1",
                "url": "https://g1.globo.com"
            }
        }
    ]
}

Missing a source from Brazil? Suggest a source.

Brazil News API

Categories

Request and live response