API InfoCEP.net

A documentação completa para integrar nossos dados de geolocalização e endereçamento.

Como Começar

  1. Crie uma conta: Clique no ícone de perfil para se registrar.
  2. Gere sua chave: No seu perfil, clique em 'Gerar Nova Chave' na seção 'Suas Chaves de API'.
  3. Faça uma requisição: Use sua chave para autenticar suas chamadas.

Buscar um CEP (Endereço e Geometria)

GET

https://infocep.net/api/cep/{cep}?api_key={key}**&geom_type={type}**

Retorna as informações de um logradouro pelo CEP.

Custos de Crédito
  • **1 Crédito:** Retorna os dados cadastrais (CEP, Nome, Bairro, Paridade, Números).
  • **2 Créditos:** Retorna os dados cadastrais + **Geometria Pontual** (`geom_type=point`).
  • **5 Créditos:** Retorna os dados cadastrais + **Geometria Linear** (`geom_type=linear`).
Parâmetros
Nome Tipo Descrição
{cep} string (8) O CEP a ser consultado, somente os 8 dígitos. Ex: 01000000
?geom_type string (opcional) Tipo de geometria a ser retornada.
  • Vazio ou Ausente: Retorna apenas dados cadastrais (1 crédito).
  • point: Inclui `geometria_pontual` na resposta (2 créditos).
  • linear: Inclui `geometria_linear` na resposta (5 créditos).
Exemplo de Resposta (200 OK)
1 Crédito (Padrão)
2 Créditos (Point)
5 Créditos (Linear)
{
    "cep": "4650010",
    "nome": "RUA LIBERO RIPOLE",
    "bairro_ini": "JARDIM UMUARAMA",
    "bairro_fim": "JARDIM UMUARAMA",
    "paridade": "I",
    "num_ini": "1",
    "num_fim": "999",
    "tipo_geom": "PONTO",
    "data_hora_atu": "2024-01-01"
}

Listar Estados (Geral)

GET

https://infocep.net/api/estados?api_key={key}&estado={uf}&geom={bool}

Retorna a lista de todos os estados brasileiros com cobertura (1 crédito).

**Opções com Geometria (50 créditos):** Adicione ?geom=true à URL para incluir as geometrias.

Parâmetros
Nome Tipo Descrição
?estado string (2) (opcional) Filtra por um estado específico. Se omitido, lista todos os estados. (Ex: ?estado=BA)
?geom boolean (opcional) Define se deve incluir a geometria (polígono) do estado no retorno.
  • Ausente ou false: Apenas dados cadastrais (1 crédito).
  • true: Inclui a geometria do estado (50 créditos).
Exemplo de Resposta (200 OK)
[
    { 
        "id": 1, 
        "uf": "BA", 
        "estado": "Bahia", 
        "data_hora_atu": "2024-01-01" 
    },
    // Exemplo com geometria (?geom=true)
    { 
        "id": 2, 
        "uf": "SP", 
        "estado": "São Paulo", 
        "codigo_ibge": "35", 
        "data_hora_atu": "2024-01-01", 
        "geometria": "MULTIPOLYGON((...))" 
    }
]

Buscar Cidades por Estado

GET

https://infocep.net/api/cidades/{uf}?geom={bool}&cidade={nome}

Retorna a lista de cidades com dados de geolocalização disponíveis para um estado (1 crédito).

**Opções com Geometria (25 créditos):** Adicione ?geom=true à URL para incluir as geometrias.

Parâmetros
Nome Tipo Descrição
{uf} string (2) A sigla do estado (UF), **obrigatório**. Ex: "BA"
?cidade string (opcional) Filtra por uma cidade específica. Se omitido, lista todas as cidades do estado. (Ex: ?cidade=salvador)
?geom boolean (opcional) Incluir geometria no retorno (25 créditos). (Ex: ?geom=true)
Exemplo de Resposta (200 OK)
[
    { "id": 10, "uf": "BA", "cidade": "Salvador", "data_hora_atu": "2024-01-01" },
    // Com filtro ?cidade=feira-de-santana&geom=true (25 créditos)
    { "id": 11, "uf": "BA", "cidade": "Feira de Santana", "codigo_cidade_ibge": "2910800", "geometria": "MULTIPOLYGON((...))" }
]

Buscar Bairros por Cidade

GET

https://infocep.net/api/bairros/{uf}/{cidade}?api_key={key}&bairro={nome}&geom={bool}

Retorna a lista de bairros em uma cidade específica (1 crédito).

**Opções com Geometria (250 créditos):** Adicione ?geom=true à URL para incluir as geometrias dos polígonos.

Parâmetros
Nome Tipo Descrição
{uf} string (2) A sigla do estado (UF), **obrigatório**.
{cidade} string Nome da cidade, **obrigatório**.
?bairro string (opcional) Filtra por um bairro específico. Se omitido, lista todos os bairros da cidade. (Ex: ?bairro=brotas)
?geom boolean (opcional) Define se deve incluir a geometria do polígono do bairro.
  • Ausente ou false: Apenas dados cadastrais (1 crédito).
  • true: Inclui a geometria do bairro (250 créditos).
Exemplo de Resposta (200 OK)
[
    { "id": 50, "uf": "BA", "cidade": "Salvador", "nome": "Brotas", "data_hora_atu": "2024-01-01" },
    // Com geometria (?geom=true - 250 créditos):
    { "id": 51, "nome": "Itapuã", "geometria": "POLYGON((...))" }
]

Buscar Setores Censitários por Município

GET

https://infocep.net/api/setores/{uf}/{cidade}?api_key={key}&cod_setor={codigo}&geom={bool}

Retorna dados dos setores censitários de um município (1 crédito por setor).

**Opções com Geometria (50 créditos):** Adicione ?geom=true à URL para incluir as geometrias.

Parâmetros
Nome Tipo Descrição
{uf} string (2) A sigla do estado (UF), **obrigatório**.
{cidade} string Nome da cidade, **obrigatório**.
?cod_setor string (opcional) Filtra por um Código de Setor Censitário específico. Se omitido, lista todos os setores do município. (Ex: ?cod_setor=290005705000001)
?geom boolean (opcional) Define se deve incluir a geometria do setor censitário.
  • Ausente ou false: Apenas dados cadastrais (1 crédito).
  • true: Inclui a geometria (50 créditos).
Exemplo de Resposta (200 OK)
[
    { 
        "id": 100, 
        "codigo_ibge": "290005705000001",
        "municipio": "Salvador-BA", 
        "ano": 2022 
    },
    // Com geometria (?geom=true - 50 créditos):
    { 
        "id": 101, 
        "codigo_ibge": "290005705000002", 
        "geometria": "POLYGON((...))" 
    }
]

Buscar Endereçamentos (Imóveis)

GET

https://infocep.net/api/enderecos/{cod_ibge}/{cep}

Retorna a lista de imóveis (endereçamentos) de um setor censitário, filtrada por CEP (1 crédito).

**Parâmetros de Filtro:** Permite filtrar por endereco, numero, ou tipo (como 'Residencial', 'Comercial', etc.).

Parâmetros
Nome Tipo Descrição
{cod_ibge} string Código do Setor Censitário.
{cep} string (Opcional) Filtro de CEP para a rua específica.
Exemplo de Resposta (200 OK)
[
    {
        "cep": "40285000",
        "endereco": "AVENIDA DOM JOÃO VI",
        "numero": 125,
        "tipo": "Domicílio particular",
        "geometria": "POINT(lat lng)"
    },
    // ...
]

Atualizações

GET

https://infocep.net/api/atualizacoes

Retorna a lista de todas atualizações feitas em um periodo (0 crédito).

**Parâmetros de Filtro:** Permite filtrar por data inicial e data final

Parâmetros
Nome Tipo Descrição
{data_ini} string (Opcional) Data inicial.
{data_fim} string (Opcional) Data Final.
Exemplo de Resposta (200 OK)
[
    {
    "id": "18154503",
    "data": "16/10/2025",
    "hora": "16:08:18",
    "feature": "Geometria linear CEP",
    "tipo": "Inclusao",
    "estado": "SP",
    "cidade": "IBIUNA"
  },
    // ...
]

Buscar Postes da Rede Elétrica

GET

https://infocep.net/api/postes/{cod_ibge}

Retorna a lista de postes da rede de distribuição para um município/setor censitário (5 créditos).

Parâmetros
Nome Tipo Descrição
{cod_ibge} string Código do Setor Censitário ou Município.
Exemplo de Resposta (200 OK)
[
    {
        "id": "12345",
        "tipo": "CONCRETO",
        "altura": "12m",
        "esforco": "200daN",
        "geometria": "POINT(-46.000 -23.000)"
    },
    // ...
]

Teste a API

URL de Requisição:

Selecione um endpoint para ver a URL...

Status: Aguardando...

Resultado:

Exemplos de Uso

Aprenda a consumir nossa API com exemplos práticos em diferentes linguagens de programação.

VBA para AutoCAD

Este exemplo busca um CEP e exibe a latitude e longitude na janela de depuração do AutoCAD.


Sub BuscarCEP()
    Dim http As Object
    Set http = CreateObject("MSXML2.XMLHTTP")

    Dim url As String
    url = "https://infocep.net/api/cep/40285000?api_key=SUA_CHAVE_AQUI"

    http.Open "GET", url, False
    http.send

    If http.Status = 200 Then
        Dim json As String
        json = http.responseText

        ' Simplificado para encontrar a lat/lng na string JSON
        Dim latPos As Integer
        Dim lngPos As Integer

        latPos = InStr(json, """lat"":")
        lngPos = InStr(json, """lng"":")

        If latPos > 0 And lngPos > 0 Then
            Dim lat As String, lng As String
            lat = Mid(json, latPos + 7, 10)
            lng = Mid(json, lngPos + 7, 10)
            Debug.Print "Latitude: " & lat
            Debug.Print "Longitude: " & lng
        End If
    Else
        Debug.Print "Erro ao buscar o CEP: " & http.Status & " - " & http.responseText
    End If

    Set http = Nothing
End Sub
AutoLISP

Este exemplo busca um CEP e exibe os dados no console do AutoCAD.


(defun C:BuscarCEP ( / url http response)
  (setq url "https://infocep.net/api/cep/40285000?api_key=SUA_CHAVE_AQUI")
  (setq http (vlax-create-object "MSXML2.XMLHTTP"))
  (vlax-invoke-method http 'Open "GET" url :vlax-false) ;; Use :vlax-false para síncrono
  (vlax-invoke-method http 'Send)
  (setq response (vlax-get-property http 'ResponseText))
  (princ (strcat "\nResposta da API: " response "\n"))
  (vlax-release-object http)
  (princ)
)
JavaScript (Fetch API)

Exemplo de como fazer uma requisição assíncrona em JavaScript, comum em aplicações web.


async function buscarCepJs(cep, apiKey) {
    const url = `https://infocep.net/api/cep/${cep}?api_key=${apiKey}`;
    try {
        const response = await fetch(url);
        if (!response.ok) {
            const error = await response.json();
            throw new Error(error.message);
        }
        const data = await response.json();
        console.log("Dados do CEP:", data);
        return data;
    } catch (error) {
        console.error("Erro ao buscar CEP:", error.message);
    }
}

// Exemplo de uso:
buscarCepJs("40285000", "SUA_CHAVE_AQUI");
C# (.NET Core)

Exemplo de requisição em C# usando HttpClient para uma aplicação backend.


public async Task<string> GetCepDataAsync(string cep, string apiKey)
{
    using (var client = new HttpClient())
    {
        var url = $"https://infocep.net/api/cep/{cep}?api_key={apiKey}";
        try
        {
            HttpResponseMessage response = await client.GetAsync(url);
            response.EnsureSuccessStatusCode(); // Lança exceção para códigos de erro

            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine(responseBody);
            return responseBody;
        }
        catch (HttpRequestException e)
        {
            Console.WriteLine($"Erro na requisição: {e.Message}");
            return null;
        }
    }
}