🔌 API REST · JSON
Dados de Todos os Municípios
Brasileiros em uma API
5.570 municípios. IDH, PIB, segurança, mercado de trabalho, conectividade e mais. Acesse via REST — sem complicação.
5.570
Municípios
27
Estados
15+
Variáveis
4
Idiomas
Planos e Preços
Sem taxa de setup. Cancele a qualquer momento.
Free
R$ 0/mês
100 req/dia por IP
- GET /v1/cidade/{slug}
- GET /v1/ranking
- GET /v1/estados
- Dados básicos do município
- IDH, PIB per capita, população
- —
- —
- —
Starter
R$ 299/mês
10.000 req/mês
- Tudo do Free
- GET /v1/cidades (com filtros)
- GET /v1/comparar
- GET /v1/custo-vida/{uf}
- Comparação entre 2 cidades
- Custo de vida — capitais
- —
- —
Mais popular
Pro
R$ 990/mês
ou US$ 199/mês
100.000 req/mês
- Tudo do Starter
- Economia: PIB setorial + crédito
- Mercado de trabalho (RAIS)
- Segurança: homicídios/100k
- Conectividade: % fibra óptica
- CNPJ por bairro
- Summary em ZH (Mandarim)
- Suporte prioritário
Enterprise
Consulta
Ilimitado
- Tudo do Pro
- SLA garantido
- IP fixo / whitelist
- Dataset completo (.json)
- Suporte dedicado
- NDA disponível
- Faturamento em nota fiscal
- Onboarding personalizado
Como Começar
O plano Free está disponível imediatamente — sem cadastro. Use seu IP como identificador e faça até 100 requisições por dia. Para os planos pagos, clique no botão abaixo, conclua o pagamento (cartão, boleto, Pix) e receba sua chave de API por e-mail em segundos.
Endpoints Disponíveis
Base URL: https://api.scorecidades.com.br
Free
GET/v1/cidade/{slug}Dados básicos do município
GET/v1/rankingRanking por IDH / PIB / Score
GET/v1/estadosLista todos os estados
Starter
GET/v1/cidadesLista com filtros avançados
GET/v1/compararComparar 2 municípios
GET/v1/custo-vida/{uf}Custo de vida por capital
Pro
GET/v1/cidade/{slug}/economiaPIB setorial + crédito bancário
GET/v1/cidade/{slug}/mercado-trabalhoSalário médio + % ensino superior (RAIS)
GET/v1/cidade/{slug}/segurancaHomicídios por 100k habitantes
GET/v1/cidade/{slug}/conectividade% fibra óptica (Anatel 2024)
GET/v1/bairros/{slug}CNPJ por bairro
Exemplo de Uso
Uma chamada para obter dados de São Paulo
# Plano Free — sem autenticação (limite por IP)
curl https://api.scorecidades.com.br/v1/cidade/sao-paulo
# Plano Starter/Pro — com chave de API
curl -H "x-api-key: sk_live_SEU_TOKEN" \
https://api.scorecidades.com.br/v1/cidade/sao-paulo/economia
# Resposta (JSON)
{
"cidade": "São Paulo",
"uf": "SP",
"pib_per_capita": 62450,
"idh": 0.805,
"score_investidor": 87.3,
"populacao": 12325232
}# Idiomas suportados (?lang=pt|en|es|zh) curl -H "x-api-key: sk_live_SEU_TOKEN" \ "https://api.scorecidades.com.br/v1/cidade/sao-paulo?lang=en" # Comparar duas cidades (Starter+) curl -H "x-api-key: sk_live_SEU_TOKEN" \ "https://api.scorecidades.com.br/v1/comparar?a=sao-paulo&b=curitiba"
Perguntas Frequentes
Dúvidas sobre a API do Score de Cidades
De onde vêm os dados?
Os dados integram IBGE (BD Compacto), RAIS 2022, Anatel 2024, ESTBAN 2025 (Banco Central), SIM/Ministério da Saúde 2022 e Receita Federal (CNPJ). Cobertura de 99,7% dos municípios para a maioria dos indicadores.
Como recebo minha chave após o pagamento?
Automaticamente por e-mail em até 2 minutos após a confirmação do pagamento (cartão) ou compensação do boleto/Pix. A chave começa com sk_live_.
Posso usar em produção no plano Free?
Sim! O plano Free não exige cadastro. O limite é de 100 requisições por dia por IP, o que é suficiente para protótipos e pequenos projetos.
Os dados são atualizados com que frequência?
Os dados estruturais (IDH, PIB, RAIS) seguem o ciclo anual das fontes oficiais. Dados de conectividade (Anatel) são atualizados semestralmente. O endpoint de custo de vida é atualizado mensalmente.
Há suporte para outros idiomas?
Sim. Todos os endpoints aceitam o parâmetro ?lang=pt|en|es|zh. O plano Pro inclui investment_summary gerado por IA em Mandarim (ZH), ideal para investidores asiáticos.
Pronto para Começar?
Acesse dados de 5.570 municípios agora mesmo. Sem burocracia.