Búsqueda por lotes

Clasifica hasta 100 direcciones IPv4 en una sola llamada. Diseñado para procesos de detección de fraude, gestión de riesgos y moderación de contenidos que gestionan picos de tráfico.

Punto final de la API

PUBLICAR https://vpn-proxy-detection.whoisxmlapi.com/api/v1/ip/batch

La API espera que los parámetros estén codificados en formato JSON en el cuerpo de cada solicitud.

Ejemplo de solicitud CURL

curl https://vpn-proxy-detection.whoisxmlapi.com/api/v1/ip/batch -X POST -H "Content-Type: application/json" -d '{"apiKey": "YOUR_API_KEY", "ips": ["8.8.8.8", "1.1.1.1", "185.220.101.1"]}'

Ejemplo de cuerpo de una solicitud POST

{
    "apiKey": "YOUR_API_KEY",
    "ips": [
        "8.8.8.8",
        "1.1.1.1",
        "185.220.101.1"
    ],
    "min_confidence": 0.5
}

La activación de tu cuenta tarda hasta un minuto tras el registro.

Parámetros de entrada

apiKey

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

ips

Obligatorio. Matriz de cadenas.

Lista de direcciones IPv4 que se deben clasificar. Máximo de 100 entradas por solicitud.

confianza_mínima

Opcional. Flotante.

Solo se devuelven las atribuciones cuya confianza en la señal sea mayor o igual que este valor.

Valores permitidos: [0, 1].

Valor por defecto: 0.

Ejemplo de resultado

{
    "results": [
        {
            "ip": "1.1.1.1",
            "network": "1.1.1.0\/24",
            "classification": "cdn",
            "provider": "Cloudflare",
            "confidence": 0.97,
            "source": "asn_classification",
            "detection_method": "asn_classification",
            "first_seen": "2024-01-15T08:30:00Z",
            "last_seen": "2026-05-20T11:04:00Z",
            "observation_count": 412,
            "hits_days_pct": null,
            "providers_num": 0,
            "confidence_decay": 0.0,
            "freshness_class": "current",
            "is_vpn": false,
            "is_proxy": false,
            "is_tor": false,
            "is_relay": false,
            "is_hosting": false,
            "is_cdn": true,
            "is_residential_proxy": false,
            "is_residential_proxy_high_confidence": false,
            "is_residential_proxy_mobile": false,
            "is_open_proxy": false,
            "is_corporate_vpn": false,
            "risk_score": 97,
            "asn": 13335,
            "asn_org": "CLOUDFLARENET",
            "cdn_operator": "cloudflare",
            "asn_abuse": {
                "abuse_score": 4,
                "abuse_level": "low"
            },
            "metadata": {
                "raw_score": 97,
                "signals": null,
                "dns_enrichment": null,
                "tls_enrichment": null
            },
            "observed_location": null
        },
        {
            "ip": "185.220.101.1",
            "network": "185.220.101.0\/24",
            "classification": "tor",
            "provider": null,
            "confidence": 1.0,
            "source": "port_scan",
            "detection_method": "port_scan",
            "first_seen": "2024-01-15T08:30:00Z",
            "last_seen": "2026-05-21T08:59:09Z",
            "observation_count": 127,
            "hits_days_pct": 47.78,
            "providers_num": 0,
            "confidence_decay": 0.6650,
            "freshness_class": "current",
            "is_vpn": false,
            "is_proxy": false,
            "is_tor": true,
            "is_relay": false,
            "is_hosting": false,
            "is_cdn": false,
            "is_residential_proxy": false,
            "is_residential_proxy_high_confidence": false,
            "is_residential_proxy_mobile": false,
            "is_open_proxy": false,
            "is_corporate_vpn": false,
            "risk_score": 100,
            "asn": 60729,
            "asn_org": "ZWIEBELFREUNDE",
            "cdn_operator": null,
            "asn_abuse": {
                "abuse_score": 88,
                "abuse_level": "high"
            },
            "metadata": {
                "raw_score": 100,
                "signals": { "open_ports": [9001, 9030] },
                "dns_enrichment": null,
                "tls_enrichment": null
            },
            "observed_location": null
        }
    ],
    "count": 2
}

Code: 200 OK.

Parámetros de salida

resultados

Matriz. Un objeto de clasificación por cada dirección IP de entrada, en el mismo orden que la solicitud.

Cada elemento tiene la misma estructura que la respuesta de una sola IP. Consulta «Realización de solicitudes » para obtener descripciones por campo.

recuento

Entero. El número de clasificaciones devueltas. En caso de éxito, coincide con la longitud de la matriz «ips» de entrada.

Acceso gratuito

Tras registrarte, obtienes automáticamente un plan de suscripción gratuito limitado a 10 consultas.

Límites de uso y regulación de solicitudes

El número máximo de solicitudes por segundo es de 30. En caso de que se superen este límite, las solicitudes posteriores serán rechazadas hasta el segundo siguiente.

Esta API también está disponible con un equilibrador de carga específico y un punto final premium para permitir consultas más rápidas como parte de nuestros servicios de API Premium y paquetes de API Enterprise.