Distância

Calcule distâncias entre CEPs em linha reta ou por rota rodoviária.

Endpoint Base distancia.apibrasil.pro Autenticação API Key (Bearer) Formato JSON Rate Limit 100 req/min

Endpoints

GET /distancia

Calcula distância entre dois CEPs

Parâmetros

Nome Tipo Obrigatório Descrição
cep_origem string ✅ Sim CEP origem (XXXXX-XXX ou XXXXXXXX)
cep_destino string ✅ Sim CEP destino (XXXXX-XXX ou XXXXXXXX)
unidade string ❌ Não km, milhas, metros ou todos (padrão: todos)
modo string ❌ Não reta, rota ou ambos (padrão: reta)

Exemplo de Requisição

curl -X GET "https://distancia.apibrasil.pro/distancia?cep_origem=01001000&cep_destino=20040030&unidade=todos&modo=ambos" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}
POST /distancia/multipla

Calcula distâncias entre múltiplos CEPs (até 10x10)

Parâmetros

Nome Tipo Obrigatório Descrição
origens array ✅ Sim Array de CEPs origem (máx 10)
destinos array ✅ Sim Array de CEPs destino (máx 10)

Exemplo de Requisição

curl -X POST "https://distancia.apibrasil.pro/distancia/multipla" -H "Authorization: Bearer sua_api_key" -H "Content-Type: application/json" -d '{"origens":["01001000","20040030"],"destinos":["70040000","80010000"]}'

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}
GET /geocode/{cep}

Retorna coordenadas (latitude/longitude) de um CEP

Parâmetros

Nome Tipo Obrigatório Descrição
cep string ✅ Sim CEP para geocodificação

Exemplo de Requisição

curl -X GET "https://distancia.apibrasil.pro/geocode/01001000" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}
GET /validar/{cep}

Valida se um CEP existe e é válido

Parâmetros

Nome Tipo Obrigatório Descrição
cep string ✅ Sim CEP para validação

Exemplo de Requisição

curl -X GET "https://distancia.apibrasil.pro/validar/01001000" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}
GET /api/health

Health check da API

Exemplo de Requisição

curl -X GET "https://distancia.apibrasil.pro/api/health"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}