Brasil API — Free Brazilian Public Data API (No Key)

TL;DR

Brasil API aggregates Brazilian public data from various government sources into a single, developer-friendly REST API. It covers national holidays, CEP postal code lookup, CNPJ business registry, DDD area codes, FIPE vehicle pricing tables, IBGE census data, and bank information. All endpoints are free and require no authentication. The data is sourced directly from official Brazilian government databases, ensuring accuracy and reliability. Essential for any application serving the Brazilian market.

Quick start: https://brasilapi.com.br/api/feriados/v1/2024

No API key needed — just make a request!

How to Use This API

1. Get Brazilian Holidays for 2024

https://brasilapi.com.br/api/feriados/v1/2024

2. Look Up a CEP (Postal Code)

https://brasilapi.com.br/api/cep/v1/01310994

3. Search CNPJ (Business Registry)

https://brasilapi.com.br/api/cnpj/v1/00000000000191

4. JavaScript — Holiday Calendar

fetch('https://brasilapi.com.br/api/feriados/v1/2024')
  .then(r => r.json())
  .then(holidays => {
    holidays.forEach(h => {
      console.log(`${h.date}: ${h.name} (${h.type})`);
    });
  });

5. Python — Lookup CEP

import requests

cep = '01310994'
data = requests.get(
    f'https://brasilapi.com.br/api/cep/v1/{cep}'
).json()

print(f"CEP: {data['cep']}")
print(f"Street: {data['street']}")
print(f"Neighborhood: {data['neighborhood']}")
print(f"City: {data['city']} - {data['state']}")

2024 Brazilian holidays: https://brasilapi.com.br/api/feriados/v1/2024

Try This URL Now

Frequently Asked Questions

What endpoints does Brasil API offer?: Major endpoints include: /api/cep/v1/{cep} (ZIP codes), /api/cnpj/v1/{cnpj} (business), /api/feriados/v1/{year} (holidays), /api/fipe/v1/ (vehicle prices), /api/banks/v1/ (bank info), /api/ddd/v1/{ddd} (area codes), and /api/ibge/ (census data).
Is the CEP data up to date?: Yes, the CEP data is sourced from Correios (Brazilian postal service) and is regularly updated to reflect new addresses and neighborhood changes.
How do I use the FIPE vehicle price table?: First query /api/fipe/v1/tabelas to get available price tables, then use the table ID to search for makes, models, and years.
What format is the response in?: All responses are in JSON format. The API uses standard HTTP response codes and descriptive error messages in Portuguese.
Are there any rate limits?: Brasil API is free to use with no documented rate limits. As a public service, reasonable usage is expected to maintain availability for all users.
Can I use this in production?: Yes, Brasil API is designed for production use. Many Brazilian companies rely on it for CEP validation, CNPJ verification, and holiday calculations.

API Details

API URL: https://brasilapi.com.br/api
Documentation: brasilapi.com.br
Category: Government
Authentication: Not Required
Geographic Coverage: Brazil (BR) — all Brazilian states and municipalities

What You Can Build

E-commerce checkout with automatic address lookup from CEP
Business verification tool that validates CNPJ numbers
National holiday calendar integrated into scheduling apps
Vehicle pricing guide using official FIPE table data
Bank branch locator using bank and DDD area code endpoints