Cómo realizar solicitudes

Obligatorio. Obtén tu clave API personal en la página «Mis productos ».

Obligatorio. La dirección IPv4 que se va a clasificar. Se especifica como un segmento de la ruta de la URL de la solicitud; por ejemplo, /api/v1/ip/185.220.101.1.

La dirección IPv4 consultada, devuelta.

Cadena o nulo. El rango CIDR al que pertenece la dirección IP, si se conoce.

Cadena. El tipo de detección de la IP.

Valores permitidos: vpn, corporate_vpn, proxy, hosting, cdn, tor, relay, residential_proxy, residential_proxy_likely, residential_proxy_mobile, datacenter_proxy, mobile_proxy, suspected_vpn, suspected_proxy, unknown.

Cadena de caracteres o nulo. Proveedor asociado a la dirección IP (por ejemplo, una marca de VPN, una red de proxies residenciales o una empresa de alojamiento web). Nulo cuando no hay información disponible.

Número real comprendido entre [0, 1]. Nivel de confianza calibrado en la clasificación. Los valores más altos indican una evidencia más sólida.

Cadena. El método de detección que generó el registro (por ejemplo, mslm, port_scan, proxy_enum, netflow_analysis, asn_classification).

Cadena. Igual que en el código fuente (campo heredado, que se mantiene por motivos de compatibilidad con versiones anteriores).

Cadena (ISO-8601) o nulo. Fecha en la que se detectó por primera vez la dirección IP.

Cadena (ISO-8601) o nulo. Fecha y hora de la última vez que se detectó la dirección IP.

Número entero. Número total de veces que se ha detectado la dirección IP (accesos).

Valor flotante o nulo. Persistencia: el porcentaje de días dentro del periodo de observación móvil de 90 días en los que se observó que la IP era un proxy activo o una salida de VPN (días de observación distintos ÷ 90 × 100).

High (>50) indicates a consistently active exit; low (<5) indicates sporadic or one-shot activity. Null when the result comes from a network-range detection with no per-IP observation history.

Número entero. Número de redes proxy o VPN distintas a través de las cuales se ha observado que la dirección IP actúa como punto de salida. Un valor igual o superior a 2 indica que la dirección IP se comparte o se revende a través de varias redes comerciales, lo que constituye una señal clara de que se trata de un proxy. El valor 0 significa que no hay historial de enumeración por dirección IP (solo detección a nivel de rango).

Valor entre [0, 1,5]. Puntuación compuesta de solidez de la evidencia: factor de actualidad × consistencia × refuerzo por múltiples proveedores. Los valores superiores a 1,0 indican IP activos a diario y con múltiples proveedores; 0,0 significa que nunca se ha observado a nivel de punto. Para obtener una puntuación normalizada entre 0 y 1, utilice min(decaimiento_de_confianza, 1,0).

Cadena. El grupo de antigüedad de las observaciones se calcula a partir de «last_seen», por lo que puedes filtrar sin tener que hacer cálculos con fechas.

Valores permitidos: actual (observado en el último día), reciente (la última semana), obsoleto (los últimos 90 días), congelado (hace más de 90 días o nunca se ha observado).

Boolean. True if the classification is in {vpn, vpn_concentrator, corporate_vpn, commercial_vpn, vpn_hosting} (confirmed VPN endpoints). Does not include tor, relay, suspected_vpn, or vpn_suspect — tor/relay have dedicated booleans; suspected_vpn/vpn_suspect are corroboration-only signals that do not set is_vpn. This asymmetry with is_proxy is deliberate: suspected_proxy does set is_proxy, but suspected_vpn/vpn_suspect never set is_vpn.

Booleano. Es verdadero si la clasificación está en {proxy, datacenter_proxy, mobile_proxy, suspected_proxy}. No incluye los proxies residenciales (véase is_residential_proxy). Para buscar cualquier tipo de proxy, combina is_proxy O is_residential_proxy.

Booleano. Es «True» si la dirección IP es un nodo de salida de Tor (clasificación «tor»).

Booleano. Verdadero si la clasificación es «relay »: un servicio de retransmisión que preserva la privacidad (por ejemplo, Apple Private Relay). Se diferencia de «is_vpn»: los servicios de retransmisión dirigen el tráfico de los usuarios a través de una salida gestionada por el proveedor, sin que el usuario pueda seleccionar el punto final.

Booleano. Verdadero si la dirección IP pertenece a un centro de datos o a un proveedor de alojamiento web.

Booleano. Es «True» si la dirección IP pertenece a una red de distribución de contenidos.

Boolean. True if the classification is in {residential_proxy, residential_proxy_likely, residential_proxy_mobile}. Mutually exclusive with is_proxy; use the more specific booleans below to filter further.

Booleano. Es verdadero si la clasificación es «residential_proxy» (el nivel de precisión ≥85 %). Subconjunto de «is_residential_proxy».

Booleano. Verdadero si «classification» == «residential_proxy_mobile »: se han detectado direcciones IP de operadores de telefonía móvil como proxies. Subconjunto de «is_residential_proxy».

Booleano. Es «True» cuando la dirección IP aparece en una lista pública de proxies abiertos. Se diferencia de «is_proxy»: todo proxy abierto es también un proxy, pero la mayoría de los proxies no figuran en las listas públicas.

Booleano. Es «True» si la IP corresponde a una VPN de tipo dispositivo (Fortinet, Pulse Secure, Cisco AnyConnect, etc.). Subindicador de «is_vpn».

Número entero comprendido entre [0, 100]. Se calcula como «confianza × 100», con un aumento de +10 para los tipos de clasificación de alto riesgo.

Número entero o nulo. Número del sistema autónomo que anuncia la dirección IP.

Cadena de caracteres o valor nulo. Nombre de la organización registrada para el ASN.

Cadena o nulo. Marca normalizada del operador de CDN (en minúsculas), p. ej., akamai, fastly, cloudflare, aws_cloudfront. Solo puede ser distinto de nulo cuando classification == cdn.

Objeto o nulo. Puntuación de abusos a nivel de ASN. Disponible en todos los planes; los planes premium (Growth+) incluyen el desglose completo:

abuse_score — número entero de 0 a 100, nivel de abuso para este ASN (todos los niveles).

abuse_level — cadena: bajo, moderado, alto, crítico (todos los niveles).

flagged_ratio — número real entre 0,0 y 1,0; proporción de direcciones IP marcadas en el ASN (crecimiento+).

flagged_ip_count — entero, número de direcciones IP marcadas (crecimiento positivo).

total_announced_ips — entero; total de direcciones IP anunciadas por este ASN (crecimiento+).

Objeto. Señales de detección adicionales y datos de enriquecimiento (todas las claves son opcionales):

raw_score — número, el índice de confianza numérico interno (0–100).

señales — objeto, señales de detección (patrones de puertos, protocolos, etc.).

dns_enrichment — objeto, registros PTR de DNS e historial de RDNS.

tls_enrichment — objeto, análisis de certificados TLS.

Objeto o nulo. Datos geográficos, solo en los niveles premium (Growth+); nulo cuando no hay datos de ubicación observados disponibles. Claves:

exit_country — cadena o nulo; código de país ISO 3166-1 alfa-2 de la IP de salida.

user_countries — matriz de cadenas o valor nulo; países en los que se han detectado usuarios con esta dirección IP.

user_country_count — número entero o nulo; número de países distintos de los usuarios.

latitud_observada / longitud_observada — número o nulo, coordenadas del punto de salida observado.

observed_countries — matriz de cadenas de caracteres; países en los que se ha observado este concentrador.

observation_readings — cadena o nulo, metadatos sobre las observaciones.

2 solicitudes por minuto

30 solicitudes por minuto

100 solicitudes/min

250 solicitudes/min

500 solicitudes/min

A medida: ponte en contacto con nosotros.