Ir al contenido
POST AI agent ready /v1/address/validate

API de validación de direcciones: verificación de direcciones gratuita

Envíe una cadena de dirección de formato libre y obtenga componentes estructurados (número de casa, carretera, ciudad, estado, código postal, país), coordenadas GPS, una puntuación de confianza y la dirección formateada. Utiliza codificación geográfica para verificar que la dirección existe y es analizable. Devuelve 404 si no se encuentra ninguna coincidencia.

Parameters

stringrequired

Freeform address to validate.

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

Validar direcciones de envío al finalizar la compra

Verifique las direcciones de envío ingresadas por el cliente antes de procesar los pedidos. Detecte errores tipográficos, direcciones incompletas y ubicaciones inexistentes antes de que lleguen a su equipo de cumplimiento. Reduce las entregas fallidas y los costos de devolución al remitente.

Estandarice los formatos de direcciones en todos los sistemas

Normalice las direcciones procedentes de importaciones de CRM, cargas de CSV y envíos de formularios en un formato estructurado coherente. Garantiza que su base de datos tenga registros de direcciones limpios y geocodificados para análisis y logística.

Complete previamente los campos del formulario a partir de la entrada parcial de la dirección

Utilice los componentes estructurados de validación para completar automáticamente los campos de ciudad, estado y código postal después de que un usuario ingrese una dirección postal. Reduce el abandono de formularios y los errores de entrada de datos.

Frequently asked questions

¿Qué tan precisa es la validación de la dirección?
El punto final utiliza datos de codificación geográfica de OpenStreetMap. Es fuerte para direcciones conocidas en América del Norte y Europa. Las direcciones rurales o de nueva construcción pueden tener puntuaciones de confianza más bajas o no arrojar resultados.
¿Qué significa la puntuación de confianza?
La puntuación de confianza (0 a 1) refleja qué tan bien coincide la entrada con el resultado de la codificación geográfica. Las puntuaciones superiores a 0,7 indican una buena coincidencia. Las puntuaciones inferiores a 0,4 sugieren que la dirección puede ser ambigua o coincidir parcialmente.
¿Esto verifica que la dirección existe como una dirección postal real?
No. Este punto final geocodifica la dirección y devuelve datos estructurados. Confirma que la ubicación es reconocida por las bases de datos cartográficas, no que el correo pueda entregarse allí. Para la verificación de entrega de USPS, necesita una API de servicio postal.
¿Puedo validar direcciones internacionales?
Sí. El servicio de geocodificación cubre direcciones en todo el mundo. El campo country_code en la respuesta le indica a qué país se resolvió la dirección.
¿Qué pasa si la dirección es demasiado vaga?
Las entradas vagas como "Calle principal" pueden devolver un resultado con poca confianza o coincidir con una ubicación incorrecta. Incluya ciudad, estado o país para obtener mejores resultados.

Get your API key

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

Sign up free View full docs