Brasil API vs brapi: APIs de dados do Brasil e da B3

Quem busca "Brasil API" quase sempre procura a BrasilAPI, um projeto aberto que entrega dados públicos do Brasil em JSON: CEP, CNPJ, bancos, feriados, tabela FIPE e outros. A brapi é uma API do mercado financeiro: cotações da B3, histórico de preços, dividendos, fundamentos, FIIs, opções e Tesouro Direto.

As duas quase não se cruzam. Em muitos projetos, elas trabalham juntas.

Resposta curta

O que a BrasilAPI oferece

A BrasilAPI nasceu para resolver um problema simples. A API dos Correios não aceitava chamadas direto do navegador, então um CEP não podia ser consultado num site sem um servidor no meio. O projeto junta fontes públicas e devolve tudo em endpoints JSON rápidos.

O código está no GitHub com licença MIT. Em outubro de 2026, o repositório tinha mais de 11 mil estrelas. As rotas respondem sem chave e sem cadastro.

A documentação agrupa os dados assim:

Uma consulta de CEP fica assim:

curl "https://brasilapi.com.br/api/cep/v2/01310100"

{
  "cep": "01310100",
  "state": "SP",
  "city": "São Paulo",
  "neighborhood": "Bela Vista",
  "street": "Avenida Paulista"
}

A resposta real também traz o código IBGE da cidade, o fuso horário e as coordenadas.

O que ela tem de mercado financeiro

A BrasilAPI tem alguns dados de finanças, todos de cadastro ou de referência.

Dois detalhes ajudam a escolher.

A rota de taxas devolve só nome e valor. Não vem data, unidade nem série histórica:

[
  { "nome": "Selic", "valor": 13.75 },
  { "nome": "CDI", "valor": 13.65 },
  { "nome": "IPCA", "valor": 4.58 }
]

Resposta consultada em 14 de outubro de 2026.

A lista de empresas da B3 traz o código do emissor, como PETR, além de razão social, CNPJ, segmento e data de listagem. Ela não traz o ticker de negociação, como PETR4, nem preço.

O que ela não tem

Na documentação e no código-fonte da BrasilAPI, em outubro de 2026, não há cotação de ações, histórico de preços, dividendos, demonstrações financeiras, indicadores de FIIs nem preços do Tesouro Direto.

Isso não é um defeito. O foco do projeto é dado público de cadastro e de referência.

Termos de uso

Os termos da BrasilAPI ainda estão em beta. Eles pedem três coisas:

• Não fazer varredura automática dos dados.
• Não fazer requisições em loop, como testar todos os CEPs.
• Manter um volume de consultas parecido com o de uma pessoa real.

Não encontramos um limite numérico publicado. Cada rota depende de uma fonte externa, então uma fonte fora do ar derruba a rota correspondente. Em produção, use cache e trate erros 5xx.

O que a brapi oferece

A brapi é uma API REST de dados do mercado financeiro brasileiro. Você envia um ticker e recebe cotação, histórico, dividendos e fundamentos em JSON.

curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"

{
  "results": [
    {
      "requestedSymbol": "PETR4",
      "symbol": "PETR4",
      "changed": false,
      "data": {
        "shortName": "PETROBRAS PN",
        "currency": "BRL",
        "regularMarketPrice": 41.18,
        "regularMarketChange": -0.58,
        "regularMarketChangePercent": -1.39,
        "regularMarketVolume": 34024700
      }
    }
  ]
}

Os valores mostram o formato da resposta e não são a cotação atual. PETR4, MGLU3, VALE3 e ITUB4 respondem sem chave, com limite de 20 requisições por minuto por IP.

A documentação tem os parâmetros e os schemas atuais.

Planos e limites

Fora as ações de teste, dividendos, fundamentos anuais, macro e câmbio entram a partir do Startup. FIIs detalhados, Tesouro Direto, opções e futuros são do Pro. Confira os valores atuais na página de planos.

Comparação lado a lado

Como usar as duas juntas

Um cadastro de investidor mostra bem a divisão. O formulário completa o endereço pelo CEP com a BrasilAPI. A tela da carteira busca a cotação com a brapi.

import os
import requests

cep = requests.get(
    "https://brasilapi.com.br/api/cep/v2/01310100",
    timeout=10,
).json()
print(cep["street"], cep["city"], cep["state"])

token = os.getenv("BRAPI_API_KEY")
headers = {"Authorization": f"Bearer {token}"} if token else {}
cotacao = requests.get(
    "https://brapi.dev/api/v2/stocks/quote",
    params={"symbols": "PETR4"},
    headers=headers,
    timeout=10,
).json()
print(cotacao["results"][0]["data"]["regularMarketPrice"])

Outro exemplo: a lista da B3 na BrasilAPI traz o CNPJ de cada empresa. Com ele, a rota de CNPJ da BrasilAPI devolve os dados cadastrais da empresa. A brapi completa com preço, dividendos e balanço da mesma empresa.

Outras opções que aparecem na busca

Qual escolher

• Seu app precisa de endereço, empresa, banco ou feriado: use a BrasilAPI.
• Seu app mostra preço, carteira, dividendos ou indicadores da bolsa: use a brapi.
• Seu app faz as duas coisas: use as duas. Cada uma cuida da parte em que é mais forte.

Para começar com dados da bolsa, rode o exemplo de PETR4 acima. Depois crie uma chave no dashboard e leia o guia da API B3 gratuita.

Perguntas frequentes

A BrasilAPI tem cotação de ações da B3?

Não. A BrasilAPI lista empresas e fundos listados na B3, com nome, CNPJ e segmento. Ela não traz preço, histórico, dividendos nem fundamentos. Para esses dados, use uma API de mercado como a brapi.

A BrasilAPI é gratuita?

Sim. É um projeto de código aberto com licença MIT, e as rotas respondem sem chave. Os termos de uso pedem para não fazer varredura automática nem requisições em loop.

Posso usar BrasilAPI e brapi no mesmo projeto?

Sim. Use a BrasilAPI para CEP, CNPJ, bancos, feriados e FIPE. Use a brapi para cotações, histórico, dividendos, fundamentos, FIIs, opções e Tesouro Direto.

Qual API usar para Selic, CDI e IPCA?

A BrasilAPI devolve o valor atual em /api/taxas/v1. A brapi devolve séries históricas em /api/v2/macro nos planos Startup e Pro. O Banco Central também publica as séries no SGS.