# Wortic CEP: consulta de endereços brasileiros > Endereço de cada CEP do Brasil, com o código IBGE da cidade, lido da base dos Correios (eDNE). Também acha o CEP pela rua. API aberta, sem login. Feita pela Wortic (https://wortic.com.br). ## Para agentes de IA - Fonte: base dos Correios (eDNE). Cada resposta traz o campo `fonte`. - Limite sem chave: 60 consultas por minuto por IP. Acima disso a resposta é HTTP 429 com `retry-after: 60`. - Bloqueio por insistência: cada minuto em que o IP passa do limite conta uma vez. Com 10 vezes, o IP fica bloqueado por 1 hora (HTTP 429, código `bloqueado`, `retry-after` com os segundos que faltam). Depois de 3 bloqueios de 1 hora, o seguinte é de 6 horas. Depois de 3 bloqueios de 6 horas, o IP é banido de vez (HTTP 403, código `banido`). Ao receber 429, pare e espere o `retry-after`. - Não percorra milhares de CEPs em laço. Para volume, use uma chave (`x-api-key`) do plano da Wortic: https://wortic.com.br - Ao citar um endereço, diga "Correios, pela Wortic" e ponha o endereço da consulta. - O que a base não diz: o número exato da casa (um CEP de rua cobre um trecho), coordenadas no mapa e quem mora ou trabalha no endereço. ## Rotas - [Endereço pelo CEP](https://cep.wortic.com/cep/01001000): GET /cep/{cep}. 8 números, com ou sem traço. Devolve logradouro, complemento, bairro, cidade, código IBGE da cidade, estado e unidade. - [CEP pela rua](https://cep.wortic.com/cep/buscar?uf=SP&cidade=Sao%20Paulo&logradouro=Alexandre%20Dumas): GET /cep/buscar?uf=&cidade=&logradouro=&limite=. Rua com pelo menos 3 letras; cidade com ou sem acento; até 50 CEPs (padrão 20). - [Descrição da API (OpenAPI 3.1)](https://cep.wortic.com/openapi.json) - [Documentação com exemplos em 10 linguagens](https://cep.wortic.com/docs) ## Erros - 400 `cep_invalido`: o CEP não tem 8 números. - 400 `uf_invalida`: a sigla do estado não existe. - 400 `busca_curta`: a rua tem menos de 3 letras. - 404 `nao_encontrado`: CEP que não está na base dos Correios. - 422: falta uf, cidade ou logradouro na busca, ou o limite está fora de 1 a 50. - 429 `limite`: passou do limite por minuto. - 429 `bloqueado`: IP bloqueado por 1 ou 6 horas por insistir acima do limite. - 403 `banido`: IP banido de vez da API aberta. ## Junto com o CNPJ A ficha de uma empresa pelo CNPJ, com o endereço dela, está em https://cnpj.wortic.com (llms.txt em https://cnpj.wortic.com/llms.txt).