Cómo funciona la API de IPHunter

Información Básica de la API

Para comenzar a usar la API de IPHunter tienes que suscribirte a un Plan.

Suscríbete

En la respuesta de la API, tenemos un campo llamado block, que identifica el nivel de riesgo de la IP analizada. Cuando block es igual a 1 aconsejamos que el acceso del usuario analizado sea bloqueado para evitar problemas al resto de los usuarios que hacen un uso correcto de su sitio web o aplicación.

block: 0  IP residencial / no clasificada (IP segura)

block: 1  IP no residencial (Hosting, Proxy, VPN ...)

block: 2  IP no residencial y residencial (advertencia, puede alertar a personas inocentes)

Cada día reconocemos mas de 3,000 nuevas IPS que son utilizadas para ocultar la identidad real de los usuarios (entre otros motivos).

Para más información no dudes en consultar nuestra documentación.

Documentación
Información adicional

Además del tipo de conexión con nivel de seguridad (block), enviamos el nombre del pais en inglés, el código del pais, la ciudad y el ISP de la IP.

Antes de bloquear una IP en su sitio, recomendamos analizar si el usuario está intentando realizar alguna acción fraudulenta en su Aplicación. Nosotros luchamos contra el fraude en Internet, y en el 90% de los casos se utilizan Hosting, VPN o Proxy para ocultar la identificación de los usuarios.

Respuesta de ejemplo de la API

Endpoint

curl https://www.iphunter.info:8082/v1/ip/148.56.53.217 -H "X-Key: PRIVATEAPIKEY"

Respuesta Correcta

{
    "status": "success",
    "data": {
        "ip": "148.56.53.217",
        "ip_num": 2486711769,
        "country_code": "ES",
        "country_name": "Spain",
        "city": "Madrid",
        "isp": "Vodafone Espana S.A.U.",
        "block": 0
    }
}

Respuesta de Error

{
    "status": "error",
    "code": "Bad Ip Range"
}

La API responde en formato JSON. cURL es un programa de línea de comando para recuperar datos de la web mediante una consola.

Si alcanzas el límite de peticiones (por día), se devolverá un código de estado HTTP 429.