Realizar solicitudes

Obligatorio. Obtenga su clave API personal en la página Mis productos.

Obligatorio. La dirección IPv4 que se va a clasificar; por ejemplo: /api/v1?apiKey=TU_CLAVE_API&ipAddress=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 flotante en el intervalo [0, 1] o nulo. Confianza en la clasificación: los valores más altos indican una evidencia más sólida. Se devuelve en el plan Pro; nulo en los planes Intro y Starter.

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

Cadena. Igual que en source (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: porcentaje de días, dentro de una ventana móvil de observación de 90 días, en los que la IP se observó como un proxy activo o un nodo de 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 em>min(confidence_decay, 1.0).

Cadena. El grupo de antigüedad de las observaciones se calcula a partir de last_seen, así que puede filtrar sin tener que hacer cálculos con fechas.

Valores permitidos: current (observado en el último día), recent (la última semana), stale (los últimos 90 días), frozen (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, combine con 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. Es True 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. Es True 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 classification == 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.

Boolean. 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 confidence × 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 Pro y superiores 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: low, moderate, high, critical(todos los niveles).

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

flagged_ip_count — número entero, número de direcciones IP marcadas (versiones Pro y superiores).

total_announced_ips — número entero, total de direcciones IP anunciadas por este ASN (plan Pro y superiores).

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

raw_score — reservado; valor nulo en todos los planes actuales.

señales: reservadas; sin disponibilidad en ningún plan actualmente.

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 la versión Enterprise; nulo cuando no hay datos de ubicación observada 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.

observed_lat / observed_lon — 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 de texto o nulo, metadatos sobre las observaciones.

120 solicitudes/min

120 solicitudes/min

150 solicitudes/min

250 solicitudes/min.

500 solicitudes/min.

10 000 solicitudes por minuto (el mismo límite fijo para todas las claves Enterprise)