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, IBGE, DDD e coordenadas. Plano grátis para sempre, sem cadastro de cartão.

Começar grátisVer documentação
<200msLatência p95
99.9%Uptime
GrátisPlano inicial
curl https://datahub.falcon-server.com.br/private/v1/cep/01001000/search \
  -H "Authorization: Bearer <SEU_TOKEN>"

# Resposta
{
  "data": {
    "cep": "01001-000",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Sé",
    "street": "Praça da Sé",
    "ddd": "11",
    "ibge": "3550308",
    "location": { "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 servem do cache em <50ms. Sem rate-limit dos Correios estragando seu fluxo.

Coordenadas inclusas

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

SDK PHP e Node

Pacotes Composer e NPM oficiais. Tipagem completa, autocompletar funciona desde o primeiro dia.

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 contratual99.9%NãoNão
Coordenadas (lat/lng)SimNãoNão
SDK oficial PHP/NodeSimNã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?

Não. O plano grátis permite 10 requests/hora sem cadastro de cartão. Você só fornece email 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?

Retornamos HTTP 404 com `{ "error": "CEP not found" }`. Não cobramos request inválida no seu limite.

Posso usar em produção?

Sim. O plano Premium (R$ 49,90/mês) oferece 1.000 req/hora e SLA 99,9%. Empresas com volume alto usam o Enterprise (10k req/h).

Como funciona o cache?

CEPs consultados pela primeira vez batem em providers oficiais. A partir da segunda consulta vêm do nosso cache (<50ms). Atualização passiva quando os Correios mudam o cadastro.

Existe SDK pronto?

Sim. Pacote Composer `falcon/datahub-sdk` para PHP e `@falcon/datahub` no NPM para Node.js. Ambos tipados.

Outras APIs no mesmo token

Uma única conta cobre tudo. Crie agora e use todas as APIs com o mesmo plano.

API de CNPJRazão social, CNAE, QSA→API de PlacasMarca, modelo, ano, UF→API de FIPECarros, motos, caminhões→API de CPFValidação + enriquecimento→API de NCMTabela fiscal completa→API de CotaçõesB3, FIIs, câmbio, cripto→

Comece a usar a API de CEP em 2 minutos

Cria conta grátis, copia o token e faz sua primeira consulta. Sem cartão, sem trial expirando.

Começar grátisVer documentação