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

API de inteligencia IP: perfiles de IP enriquecidos con datos geográficos, de red y TLS

Devuelve un perfil completo para la dirección IP de la persona que llama, incluida la geolocalización (país, ciudad, región, coordenadas, membresía de la UE), datos de red (ASN, organización, DNS inverso), indicadores de seguridad (detección de VPN con señales de confianza), detalles de conexión TLS (versión, cifrado, protocolo) y metadatos de conexión de Cloudflare.

Code examples

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

When to use this API

Registro de acceso de confianza cero

Registre el perfil IP completo en cada evento de autenticación. Capture la ubicación geográfica, ASN, versión TLS y estado de VPN para crear una línea base de comportamiento para cada usuario. Marcar inicios de sesión que se desvían del patrón establecido.

Enriquecimiento de detección de bots

Combine datos de huellas dactilares TLS e indicadores de VPN con su canal de detección de bots existente. Los navegadores legítimos y los raspadores sin cabeza producen diferentes conjuntos de cifrado TLS y versiones de protocolo.

Huellas digitales de conexión

Utilice la versión TLS, el cifrado, el protocolo HTTP y el tiempo de ida y vuelta de TCP para crear una huella digital de conexión. Realice un seguimiento de la coherencia de las huellas dactilares en todas las sesiones para detectar fraudes sin depender de cookies.

Frequently asked questions

¿Puedo pasar una dirección IP específica al perfil?
No. Este punto final perfila la propia conexión de la persona que llama. La IP, TLS y los datos de conexión provienen directamente del borde de Cloudflare que maneja su solicitud. Para buscar IP arbitrarias, utilice el punto final /v1/ip/lookup.
¿Qué tan confiable es la detección de VPN?
La detección de VPN utiliza heurísticas como rangos de ASN de VPN conocidos y bloques de IP del centro de datos. Capta a los principales proveedores de VPN, pero no puede detectar todas las conexiones VPN. La matriz vpn_indicators explica qué señales activaron la bandera.
¿Qué datos TLS están disponibles?
La sección TLS incluye la versión TLS negociada (TLSv1.2 o TLSv1.3), el conjunto de cifrado y el protocolo HTTP (h2, h3 o http/1.1). Estos datos provienen del borde de Cloudflare y reflejan los parámetros de conexión reales.
¿Este punto final cuenta contra mi límite de tarifa?
Sí. Cuenta como una llamada API como cualquier otro punto final. Los usuarios anónimos están sujetos a la ráfaga estándar de 5 solicitudes/min y al límite de 100 solicitudes/día.
¿Los datos de geolocalización son los mismos que /v1/ip/lookup?
Los campos geográficos son idénticos en formato. La diferencia es que /v1/ip/intelligence agrega secciones de red, seguridad, TLS y conexión que /v1/ip/lookup no incluye.

Get your API key

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