🇧🇷 API COM TODAS AS CIDADES DO BRASIL ATUALIZADO 2026

Repositório atualizado com dados oficiais dos 5.570 municípios brasileiros organizados por estado

Este repositório contém uma lista completa e atualizada de todos os estados e municípios do Brasil, extraída diretamente da fonte oficial do IBGE. Os dados estão organizados de forma estruturada e prontos para uso em aplicações web, mobile ou desktop.

📊 Estatísticas dos Dados

• 27 Estados (incluindo o Distrito Federal)
• 5.570 Municípios totais
• Codificação UTF-8 para preservar acentos e caracteres especiais
• Fonte oficial: IBGE - Instituto Brasileiro de Geografia e Estatística
• Última atualização: 17/10/2025

🚀 Como Usar

Download Direto

# Clone o repositório
git clone https://github.com/seu-usuario/estado-cidades-brasil.git
cd estado-cidades-brasil

Uso em JavaScript/Node.js

// Carregar dados
const municipios = require('./municipios.json');

// Listar todos os estados
const estados = Object.keys(municipios);
console.log(estados);

// Buscar municípios de um estado
const cidadesSP = municipios['São Paulo'];
console.log(`São Paulo tem ${cidadesSP.length} municípios`);

// Buscar município específico
const encontrarMunicipio = (nome) => {
  for (const [estado, cidades] of Object.entries(municipios)) {
    if (cidades.includes(nome)) {
      return { estado, municipio: nome };
    }
  }
  return null;
};

Uso em Python

import json

# Carregar dados
with open('municipios.json', 'r', encoding='utf-8') as f:
    municipios = json.load(f)

# Listar estados
estados = list(municipios.keys())
print(f"Total de estados: {len(estados)}")

# Contar municípios por estado
for estado, cidades in municipios.items():
    print(f"{estado}: {len(cidades)} municípios")

📁 Estrutura do Projeto

estado-cidades-brasil/
├── README.md              # Este arquivo
├── municipios.json        # Dados completos em JSON
├── cidades.py            # Script de extração dos dados
├── index.html            # Site estático para visualização
└── LICENSE               # Licença MIT

🌐 Site de Demonstração

Acesse o site estático para:

• 🔍 Buscar municípios por estado
• 📊 Visualizar estatísticas dos dados
• ⬇️ Download em diferentes formatos (JSON, CSV, XML)
• 📱 Interface responsiva e moderna

🔧 Script de Atualização

O arquivo cidades.py contém o script para extrair e atualizar os dados diretamente do IBGE:

# Instalar dependências
pip install requests beautifulsoup4

# Executar script de atualização
python cidades.py

📋 Formato dos Dados

{
  "Acre": [
    "Assis Brasil",
    "Brasiléia",
    "Bujari",
    // ... outros municípios
  ],
  "Alagoas": [
    "Anadia",
    "Arapiraca",
    "Atalaia",
    // ... outros municípios
  ]
  // ... outros estados
}

🤝 Contribuindo

Contribuições são bem-vindas! Se você encontrar algum erro ou quiser sugerir melhorias:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

⚠️ Importante

• Os dados são extraídos diretamente do site oficial do IBGE
• A lista é atualizada conforme as mudanças oficiais
• Caso encontre discrepâncias, abra uma issue
• Para uso comercial, verifique as políticas do IBGE

🌐 API Gratuita

Este projeto também oferece uma API REST gratuita e livre para acessar os dados de municípios brasileiros:

Endpoint da API

https://api.kstrtech.com.br/cidades/{sigla_estado}

Como usar a API

Exemplo: Buscar cidades de São Paulo

curl https://api.kstrtech.com.br/cidades/sp

Exemplo: Buscar cidades do Rio de Janeiro

curl https://api.kstrtech.com.br/cidades/rj

Exemplo em JavaScript

// Buscar cidades de São Paulo
fetch('https://api.kstrtech.com.br/cidades/sp')
  .then(response => response.json())
  .then(data => console.log(data));

// Buscar cidades do Rio de Janeiro
fetch('https://api.kstrtech.com.br/cidades/rj')
  .then(response => response.json())
  .then(data => console.log(data));

Exemplo em Python

import requests

# Buscar cidades de São Paulo
response = requests.get('https://api.kstrtech.com.br/cidades/sp')
cidades_sp = response.json()
print(cidades_sp)

# Buscar cidades do Rio de Janeiro
response = requests.get('https://api.kstrtech.com.br/cidades/rj')
cidades_rj = response.json()
print(cidades_rj)

Características da API

• ✅ 100% Gratuita - Sem custos ou limitações
• ✅ Livre para uso - Comercial e não comercial
• ✅ Dados oficiais - Fonte IBGE
• ✅ Atualizada - Dados sempre em dia
• ✅ Rápida - Resposta em milissegundos
• ✅ CORS habilitado - Para uso em frontend

Estados disponíveis

A API suporta todas as 27 unidades federativas do Brasil (26 estados + DF):

• ac - Acre
• al - Alagoas
• ap - Amapá
• am - Amazonas
• ba - Bahia
• ce - Ceará
• df - Distrito Federal
• es - Espírito Santo
• go - Goiás
• ma - Maranhão
• mt - Mato Grosso
• ms - Mato Grosso do Sul
• mg - Minas Gerais
• pa - Pará
• pb - Paraíba
• pr - Paraná
• pe - Pernambuco
• pi - Piauí
• rj - Rio de Janeiro
• rn - Rio Grande do Norte
• rs - Rio Grande do Sul
• ro - Rondônia
• rr - Roraima
• sc - Santa Catarina
• sp - São Paulo
• se - Sergipe
• to - Tocantins

---

⭐ Se este projeto foi útil, considere dar uma estrela!