Falcon Data Hub
API de CEP — JSON REST

Consulta de CEP em milissegundos

API REST de CEP com cache inteligente. Retorna rua, bairro, cidade, estado e coordenadas. Plano grátis para sempre, sem cadastro de cartão.

Lat/LongCoordenadas inclusas
CacheApós a 1ª consulta
GrátisPlano inicial
curl https://datahub.falcon-server.com.br/private/v1/cep/01001000/search \
  -H "Authorization: Bearer <SEU_TOKEN>"

# Resposta
{
  "data": {
    "id": "01001000",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Sé",
    "street": "Praça da Sé",
    "location": { "type": "Point", "latitude": -23.5505, "longitude": -46.6333 }
  }
}

Por que usar a API de CEP do Falcon

Pensada para produção: cache, SDK pronto e dashboard de uso.

Cache inteligente

CEPs já consultados respondem do nosso cache, sem nova consulta externa. Sem rate-limit dos Correios estragando seu fluxo.

Coordenadas inclusas

Latitude e longitude no mesmo endpoint. Sem precisar pagar Google Geocoding separado.

SDK PHP

Pacote Composer oficial (quantumtecnology/falcon-datahub-sdk), com login automático e renovação de token.

Dashboard de uso

Veja em tempo real quantas requests você fez, latência média e quota restante.

Fallback automático

Se um provider externo cair, tentamos outro. Sua aplicação não vê a falha.

Hospedado no Brasil

Servidor no Brasil = menor latência para usuários BR. LGPD-friendly.

Falcon vs. alternativas populares

Por que devs escolhem Falcon mesmo com opções gratuitas

RecursoFalcon Data HubViaCEPBrasilAPI
Plano grátis para sempreSimSimSim
SLA contratualEnterpriseNãoNão
Coordenadas (lat/lng)SimNãoNão
SDK oficial PHPSimNãoNão
Dashboard de usoSimNãoNão
Outras APIs no mesmo tokenCNPJ, FIPE, Placa, BCB…NãoParcial

Perguntas frequentes sobre a API de CEP

Preciso cadastrar cartão para usar o plano grátis?

Sim. O plano Free permite 10 requisições/hora, sem cadastro de cartão. Você só informa e-mail e senha.

A API funciona com CEP do tipo "01001-000" e "01001000"?

Sim. Aceitamos com e sem hífen. Internamente normalizamos antes da consulta.

O que acontece se o CEP não existir?

A API responde HTTP 400 com uma mensagem de erro. Toda requisição conta no limite por hora do seu plano, inclusive a que não encontra resultado ou é recusada por dado inválido.

Posso usar em produção?

Sim. Iniciante (R$ 4,90/mês): 100 requisições/hora; Premium (R$ 49,90/mês): 1.000 requisições/hora; Enterprise (R$ 199,90/mês): 10.000 requisições/hora. Os limites e preços atualizados estão na página de planos.

Como funciona o cache?

CEPs consultados pela primeira vez vão às fontes externas. A partir da segunda consulta vêm do nosso cache, e o cadastro é reconsultado depois de 30 dias.

Existe SDK pronto?

Sim, para PHP: pacote Composer `quantumtecnology/falcon-datahub-sdk`. Para outras linguagens, a API é REST com token Bearer.

Comece a usar a API de CEP em 2 minutos

Crie sua conta grátis, copie o token e faça sua primeira consulta. Sem cartão, sem trial expirando.