# Achar o CEP pela rua > Quem não sabe o CEP informa o estado, a cidade e parte do nome da rua, e escolhe na lista. A busca aceita cidade com ou sem acento. Endereço: https://cep.wortic.com/guias/achar-cep-pela-rua Fonte dos dados: Correios (eDNE), pela Wortic. Wortic CEP (/) / Guias (/guias/) Achar o CEP pela rua Quem não sabe o CEP informa o estado, a cidade e parte do nome da rua, e escolhe na lista. A busca aceita cidade com ou sem acento. A rota é GET /cep/buscar?uf=&cidade=&logradouro=&limite=. Os três primeiros campos são obrigatórios; o limite vai de 1 a 50 e o padrão é 20. ## O código ``` export async function cepsDaRua(uf, cidade, rua, limite = 20) { const q = new URLSearchParams({ uf, cidade, logradouro: rua, limite: String(limite) }); const r = await fetch(`https://cep.wortic.com/cep/buscar?${q}`); const j = await r.json(); if (r.status !== 200) return { erro: j.erro?.codigo || String(r.status), itens: [] }; return { itens: j.itens.map((e) => ({ cep: e.cep_formatado, rua: e.logradouro, complemento: e.complemento, bairro: e.bairro })) }; } console.log(await cepsDaRua("SP", "São Paulo", "Alexandre Dumas", 3)); ``` ## O que volta ``` { itens: [ { cep: "04717-000", rua: "Rua Alexandre Dumas", complemento: "", bairro: "Chácara Santo Antônio (Zona Sul)" }, { cep: "04717-001", rua: "Rua Alexandre Dumas", ... }, { cep: "04717-002", rua: "Rua Alexandre Dumas", ... } ] } ``` Uma rua longa pode ter vários CEPs, cada um para um trecho. Mostre o complemento e o bairro na lista para a pessoa escolher o certo. ## Os erros da busca RespostaQuando 400 busca_curtaRua com menos de 3 letras 400 uf_invalidaA sigla do estado não existe, como "XX" 422Falta uf, cidade ou logradouro, ou o limite está fora de 1 a 50 ## Perguntas e respostas Quantas letras da rua a busca precisa? Pelo menos 3. Com menos, a API responde 400 com o código busca_curta. Preciso escrever a cidade com acento? Não. "São Paulo" e "sao paulo" dão o mesmo resultado. O que volta quando nenhuma rua combina? Uma lista vazia, com status 200: {"itens":[],"total":0}. Erro só quando falta campo, a UF não existe ou a rua é curta. Todos os guias (/guias/) · Documentação com exemplos em 10 linguagens (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)