# Autocompletar empresa pelo nome > Quem não sabe o CNPJ digita o nome e escolhe na lista. A busca devolve até 50 empresas ativas, com cidade, estado e se é matriz ou filial. Endereço: https://cnpj.wortic.com/guias/autocompletar-nome Fonte dos dados: Receita Federal, dados abertos do CNPJ, pela Wortic. Wortic CNPJ (/) / Guias (/guias/) Autocompletar empresa pelo nome Quem não sabe o CNPJ digita o nome e escolhe na lista. A busca devolve até 50 empresas ativas, com cidade, estado e se é matriz ou filial. A rota é GET /empresas?nome=&uf=. O estado é opcional. Cada item traz o CNPJ, a razão social, a cidade, o estado, a situação e se é matriz. ## O código, com espera entre teclas ``` const entrada = document.querySelector("#empresa"); const lista = document.querySelector("#sugestoes"); let espera, ultimo = ""; entrada.addEventListener("input", () => { clearTimeout(espera); const termo = entrada.value.trim(); if (termo.length < 4) { lista.replaceChildren(); return; } // a API pede 4 letras espera = setTimeout(async () => { if (termo === ultimo) return; ultimo = termo; const r = await fetch(`https://cnpj.wortic.com/empresas?nome=${encodeURIComponent(termo)}`); if (r.status !== 200) return; const { empresas } = await r.json(); lista.replaceChildren(...empresas.map((e) => { const item = document.createElement("li"); item.textContent = `${e.razao_social} · ${e.cidade}/${e.uf} · ${e.matriz ? "matriz" : "filial"}`; item.dataset.cnpj = e.cnpj; return item; })); }, 400); }); ``` A espera de 400 ms faz uma consulta quando a pessoa para de digitar, e não uma por letra. Isso mantém o seu sistema bem abaixo das 60 consultas por minuto. ## O que volta para "wortic" ``` {"termo":"wortic","empresas":[ {"cnpj":"20885605000114","razao_social":"WORTICE ENERGIA LTDA EM RECUPERACAO JUDICIAL","matriz":true,"uf":"SP","cidade":"SERTAOZINHO","situacao":"Ativa", ...}, {"cnpj":"37853407000171","razao_social":"WORTIC LTDA","matriz":true,"uf":"SP","cidade":"SAO PAULO","situacao":"Ativa", ...}, {"cnpj":"20885605000203","razao_social":"WORTICE ENERGIA LTDA EM RECUPERACAO JUDICIAL","matriz":false,"uf":"AL","cidade":"MACEIO","situacao":"Ativa", ...} ],"total":3,"fonte":"Receita Federal, dados abertos do CNPJ (base Wortic); só empresas ativas"} ``` A busca acha nomes parecidos: "wortic" trouxe também "WORTICE". Mostre cidade e estado na lista para a pessoa escolher a certa. Com a empresa escolhida, busque a ficha completa pelo CNPJ. ## Perguntas e respostas Quantas letras a busca por nome precisa? Pelo menos 4. Com menos, a API responde 400 com o código termo_curto. A busca traz empresas baixadas? Não. A busca por nome devolve só empresas ativas, até 50 por pedido. Para conferir uma empresa baixada, consulte pelo CNPJ. Como filtrar por estado? Acrescente uf ao endereço: /empresas?nome=wortic&uf=AL traz só as empresas de Alagoas. Todos os guias (/guias/) · Documentação com exemplos em 10 linguagens (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)