API de endereços · Autocomplete
Autocomplete de endereço para formulários
Ofereça sugestões enquanto a pessoa digita e reduza erros em cadastros, checkouts e aplicações brasileiras.
Sugestões rápidas para uma experiência melhor
O endpoint de autocomplete busca logradouros a partir de um prefixo e exige pelo menos dois caracteres. A aplicação cliente decide como apresentar as sugestões e quais campos deve confirmar antes de salvar.
Exemplo de requisição
Use limite de resultados conforme a experiência do seu campo e trate respostas vazias como uma etapa normal do preenchimento.
curl 'https://brasiladdress.io/api/v1/autocomplete?q=Avenida%20Pau&limit=10' \
-H 'Authorization: Bearer SUA_API_KEY'Requisitos e limites
O autocomplete depende de dados disponíveis para o prefixo pesquisado. A API aplica autenticação, rate limit e quota do plano; implemente debounce no frontend, timeout e tratamento de erros 401 e 429.