API REST · JSON · GeoJSON

API de dados geográficos para o seu sistema

CEPs com eixo e ponto, endereços de imóveis, limites de bairros e cidades, setores censitários e postes — direto no seu sistema, pagando só pelo que consultar.

Ver documentação

Em breve – API em preparação

# Buscar um CEP com o eixo do logradouro
curl "https://www.infocadtecnologia.com/api/v1/cep/04650010?geom=linear" \
  -H "X-API-Key: SUA_CHAVE"

Como começar

Crie sua contaNa Área do cliente, com o seu e-mail.
Gere uma chaveEm "Minhas chaves de API". Você pode ter uma chave por sistema e revogar quando quiser.
Compre créditosCada consulta desconta créditos do seu saldo, conforme a tabela abaixo.
Faça a chamadaEnvie a chave no cabeçalho X-API-Key de cada requisição.

Endereço basehttps://www.infocadtecnologia.com/api/v1

AutenticaçãoX-API-Key: sua_chave

FormatoJSON · geometrias em GeoJSON (WGS84)

Limite60 consultas por minuto

Créditos por consulta

Consulta	Cadastral	Com geometria
Buscar um CEP	1	2 (com ponto) · 5 (com eixo)
Endereços de um CEP (imóveis)	1	–
Listar estados	1	50 (com geometria)
Cidades de um estado	1	25 (com geometria)
Bairros de uma cidade	1	250 (com geometria)
Setores censitários	1	50 (com geometria)
Postes da rede elétrica	5	–
Atualizações da base	0	–

Inicial1.000créditosR$ –

Profissional10.000créditosR$ –

Empresa100.000créditosR$ –

Valores dos pacotes a definir.

GET/cep/{cep}

Buscar um CEP

Dados do logradouro de um CEP, com a geometria opcional (ponto ou eixo do logradouro).

1 créditoCadastral2 créditosCom ponto5 créditosCom eixo

Parâmetros

Nome	Onde	Tipo	Descrição
`cep`	caminho	texto (8)	CEP, só os dígitos. Ex.: 04650010
`geom`	opcional	point \| linear	Inclui a geometria: `point` (2 créditos) ou `linear` (5 créditos)

Exemplo de resposta

{
  "cep": "04650010",
  "logradouro": "RUA LIBERO RIPOLI",
  "bairro": "JARDIM UMUARAMA",
  "cidade": "SAO PAULO",
  "uf": "SP",
  "lado": "ímpar",
  "numero_inicial": 1,
  "numero_final": 999,
  "atualizado_em": "2026-09-18"
}

{
  "cep": "04650010",
  "logradouro": "RUA LIBERO RIPOLI",
  "...": "...",
  "geometria": {
    "type": "Point",
    "coordinates": [
      -46.678967,
      -23.65596
    ]
  }
}

{
  "cep": "04650010",
  "logradouro": "RUA LIBERO RIPOLI",
  "...": "...",
  "geometria": {
    "type": "MultiLineString",
    "coordinates": [
      [
        [
          -46.67887,
          -23.6568
        ],
        [
          -46.67896,
          -23.6565
        ],
        "..."
      ]
    ]
  }
}

{
  "erro": "CEP não encontrado."
}

GET/cep/{cep}/enderecos

Endereços de um CEP (imóveis)

Todos os números de imóveis de um CEP (cadastro do IBGE, com a higienização da Infocad), com tipo e coordenadas.

1 créditoPor consulta

Parâmetros

Nome	Onde	Tipo	Descrição
`cep`	caminho	texto (8)	CEP, só os dígitos
`unidades`	opcional	true \| false	Inclui cada unidade (apartamentos, salas, lojas) de cada número

Exemplo de resposta

[
  {
    "numero": "47",
    "logradouro": "RUA ALEXANDRINA RAMALHO",
    "tipo": "Prédio",
    "imoveis": 119,
    "latitude": -12.99155,
    "longitude": -38.47802
  },
  {
    "numero": "70",
    "...": "..."
  }
]

GET/estados

Listar estados

Estados com cobertura, com o limite (polígono) opcional.

1 créditoCadastral50 créditosCom geometria

Parâmetros

Nome	Onde	Tipo	Descrição
`uf`	opcional	texto (2)	Filtra um estado. Ex.: BA
`geom`	opcional	true \| false	Inclui o polígono do estado (50 créditos)

Exemplo de resposta

[
  {
    "uf": "BA",
    "estado": "Bahia",
    "codigo_ibge": "29"
  },
  {
    "uf": "SP",
    "estado": "São Paulo",
    "codigo_ibge": "35",
    "geometria": {
      "type": "MultiPolygon",
      "coordinates": "..."
    }
  }
]

GET/estados/{uf}/cidades

Cidades de um estado

Municípios de um estado, com o limite opcional.

1 créditoCadastral25 créditosCom geometria

Parâmetros

Nome	Onde	Tipo	Descrição
`uf`	caminho	texto (2)	Sigla do estado
`cidade`	opcional	texto	Filtra pelo nome. Ex.: feira de santana
`geom`	opcional	true \| false	Inclui o polígono do município (25 créditos)

Exemplo de resposta

[
  {
    "cidade": "SALVADOR",
    "uf": "BA",
    "codigo_ibge": "2927408"
  },
  {
    "cidade": "FEIRA DE SANTANA",
    "uf": "BA",
    "codigo_ibge": "2910800",
    "geometria": {
      "type": "MultiPolygon",
      "coordinates": "..."
    }
  }
]

GET/cidades/{codigo_ibge}/bairros

Bairros de uma cidade

Bairros oficiais de um município, com o limite opcional.

1 créditoCadastral250 créditosCom geometria

Parâmetros

Nome	Onde	Tipo	Descrição
`codigo_ibge`	caminho	texto (7)	Código IBGE do município. Ex.: 2927408
`bairro`	opcional	texto	Filtra pelo nome
`geom`	opcional	true \| false	Inclui os polígonos (250 créditos)

Exemplo de resposta

[
  {
    "bairro": "BROTAS",
    "cidade": "SALVADOR",
    "uf": "BA"
  },
  {
    "bairro": "ITAPUA",
    "...": "...",
    "geometria": {
      "type": "Polygon",
      "coordinates": "..."
    }
  }
]

GET/cidades/{codigo_ibge}/setores

Setores censitários

Setores censitários do IBGE (2022) de um município.

1 créditoPor setor50 créditosCom geometria

Parâmetros

Nome	Onde	Tipo	Descrição
`codigo_ibge`	caminho	texto (7)	Código IBGE do município
`setor`	opcional	texto (15)	Filtra um setor
`geom`	opcional	true \| false	Inclui os polígonos (50 créditos)

Exemplo de resposta

[
  {
    "setor": "292740805000001",
    "cidade": "SALVADOR",
    "uf": "BA",
    "ano": 2022
  }
]

GET/cidades/{codigo_ibge}/postes

Postes da rede elétrica

Postes da rede de distribuição de um município, com tipo, altura e esforço.

5 créditosPor consulta

Parâmetros

Nome	Onde	Tipo	Descrição
`codigo_ibge`	caminho	texto (7)	Código IBGE do município

Exemplo de resposta

[
  {
    "id": "12345",
    "material": "CONCRETO",
    "altura": "12 m",
    "esforco": "200 daN",
    "geometria": {
      "type": "Point",
      "coordinates": [
        -46,
        -23
      ]
    }
  }
]

GET/atualizacoes

Atualizações da base

O que mudou na base num período (inclusões, alterações e exclusões), para manter a sua cópia em dia.

0 créditosGrátis

Parâmetros

Nome	Onde	Tipo	Descrição
`de`	opcional	data	Data inicial. Ex.: 2026-10-01
`ate`	opcional	data	Data final
`uf`	opcional	texto (2)	Filtra um estado

Exemplo de resposta

[
  {
    "data": "2026-10-16T16:08:18",
    "tipo": "inclusao",
    "item": "Eixo de logradouro",
    "cep": "18154503",
    "cidade": "IBIUNA",
    "uf": "SP"
  }
]

Testar a API

Faça uma chamada de verdade com a sua chave e veja a resposta aqui.

Sua chaveConsultaParâmetro

// A resposta aparece aqui.