Ir al contenido
POST AI agent ready /v1/ip/lookup

API de geolocalización de IP: búsqueda gratuita de direcciones IP

Devuelve datos de geolocalización para una dirección IP, incluido país, ciudad, región, coordenadas, zona horaria, ASN y centro de datos de Cloudflare. Si no se proporciona ninguna IP, se utiliza la propia IP de la persona que llama.

Parameters

string

IPv4 or IPv6 address to geolocate. Omit to look up the caller's own IP.

Code examples

curl -X POST https://api.botoi.com/v1/ip/lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.1"}'

When to use this API

Personalice el contenido según la ubicación del visitante

Detecte el país y la ciudad de un visitante al cargar la página para mostrar precios, idiomas u opciones de envío localizados. Una página de pago SaaS puede llamar a este punto final para completar previamente el selector de moneda según el código de país del visitante.

Puntuación de fraude en canales de pago

Compare la geolocalización IP de una transacción con la dirección de facturación registrada. Marque las órdenes en las que la IP se resuelve en un país diferente al del emisor de la tarjeta y enrute las transacciones marcadas mediante revisión manual.

Registro de cumplimiento para auditorías de acceso

Registre el país y la región de cada inicio de sesión de administrador en un panel interno. Genere un informe mensual de eventos de acceso agrupados por geografía para satisfacer los requisitos de auditoría SOC 2 o GDPR.

Frequently asked questions

¿Qué tan precisos son los datos de geolocalización de IP?
La precisión a nivel de país es superior al 99%. La precisión a nivel de ciudad varía según la región, pero suele ser del 80 al 90 % para los principales ISP. Las IP y VPN de los operadores de telefonía móvil pueden resolverse en la sede del operador en lugar de en la ubicación física del usuario.
¿Este punto final admite direcciones IPv6?
Sí. Pase cualquier dirección IPv6 válida en el campo ip. La respuesta incluye los mismos campos de geolocalización que las búsquedas de IPv4.
¿Qué pasa si omito el parámetro ip?
El punto final devuelve datos de geolocalización para la propia dirección IP de la persona que llama. Esto es útil para detectar la ubicación de un visitante de un sitio web sin ningún JavaScript del lado del cliente.
¿Qué es el campo ASN?
ASN significa Número de sistema autónomo. Identifica el operador de red (como Comcast, AWS o Cloudflare) propietario del bloque de direcciones IP. El campo as_organization le proporciona el nombre legible por humanos.
¿Existe un límite de velocidad en este punto final?
Las solicitudes anónimas están limitadas a 5 por minuto según su IP. Las solicitudes autenticadas con una clave API obtienen límites más altos según su plan.

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