POST AI agent ready /v1/address/validate

API de validação de endereço - verificação de endereço gratuita

Envie uma sequência de endereço de formato livre e receba componentes estruturados (número da casa, estrada, cidade, estado, código postal, país), coordenadas GPS, uma pontuação de confiança e o endereço formatado. Usa geocodificação para verificar se o endereço existe e pode ser analisado. Retorna 404 se nenhuma correspondência for encontrada.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Valide os endereços de entrega na finalização da compra

Verifique os endereços de entrega inseridos pelo cliente antes de processar os pedidos. Identifique erros de digitação, endereços incompletos e locais inexistentes antes que cheguem à sua equipe de atendimento. Reduz entregas com falha e custos de devolução ao remetente.

Padronize formatos de endereço entre sistemas

Normalize endereços de importações de CRM, uploads de CSV e envios de formulários em um formato estruturado consistente. Garante que seu banco de dados tenha registros de endereços limpos e geocodificados para análise e logística.

Preencher previamente os campos do formulário a partir da entrada parcial do endereço

Use os componentes estruturados da validação para preencher automaticamente os campos de cidade, estado e código postal depois que um usuário inserir um endereço. Reduz o abandono de formulários e erros de entrada de dados.

Frequently asked questions

Quão precisa é a validação do endereço?

O endpoint usa dados de geocodificação do OpenStreetMap. É forte para endereços conhecidos na América do Norte e na Europa. Endereços rurais ou recém-construídos podem ter pontuações de confiança mais baixas ou não retornar resultados.

O que significa a pontuação de confiança?

A pontuação de confiança (0 a 1) reflete o quão bem a entrada corresponde ao resultado da geocodificação. Pontuações acima de 0,7 indicam uma correspondência forte. Pontuações abaixo de 0,4 sugerem que o endereço pode ser ambíguo ou parcialmente correspondido.

Isso verifica se o endereço existe como um endereço de correspondência real?

Não. Este endpoint geocodifica o endereço e retorna dados estruturados. Ele confirma que o local é reconhecido pelos bancos de dados de mapeamento, e não que a correspondência possa ser entregue lá. Para verificação de entrega do USPS, você precisa de uma API de serviço postal.

Posso validar endereços internacionais?

Sim. O serviço de geocodificação cobre endereços em todo o mundo. O campo country_code na resposta informa para qual país o endereço foi resolvido.

O que acontece se o endereço for muito vago?

Entradas vagas como "Rua Principal" podem retornar um resultado com baixa confiança ou corresponder ao local errado. Inclua cidade, estado ou país para obter melhores resultados.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.