Guía de migración · /api/v2

API compatible con AbuseIPDB

Si su herramienta ya habla AbuseIPDB APIv2, no hay código que reescribir. Cambie la URL base y la clave: misma petición, mismos nombres de campo, mismo formato de error. Una salida para servidores que agotan el límite diario, o simplemente una segunda opinión.

Consultas / día10.000cuenta verificada
Reportes / día10.000contador aparte
Base de la puntuación44listas de amenazas
PrecioGratissin planes de pago

Cambie dos cosas

Busque la dirección y la clave de AbuseIPDB en la configuración o el script de su herramienta y sustituya ambas. La ruta (/api/v2/…), los parámetros y la cabecera Key no cambian.

QuéAntesDespués
URL basehttps://api.abuseipdb.com/api/v2https://ip-db.com/api/v2
Clavesu clave de AbuseIPDBsu clave de IP-DB (ipdb_…)
Una clave de AbuseIPDB no es válida aquí; la clave de IP-DB se obtiene en un minuto desde el panel de la cuenta. Al verificar su correo el límite diario pasa de 1.000 a 10.000.

Ejemplos listos

Consultar una dirección · curl

curl -G https://ip-db.com/api/v2/check \
  --data-urlencode "ipAddress=185.220.101.1" \
  -d maxAgeInDays=90 \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "185.220.101.1", "isPublic": true, "ipVersion": 4,
#   "isWhitelisted": false, "abuseConfidenceScore": 100, "countryCode": "DE",
#   "usageType": "Data Center/Web Hosting/Transit", "isp": "…", "domain": "…",
#   "hostnames": [], "isTor": true, "totalReports": 0, "numDistinctUsers": 0,
#   "lastReportedAt": null, "ipdb": {"scoreLabel": "critical", "blacklistSources": […], …}}}

Reportar una dirección · curl

curl https://ip-db.com/api/v2/report \
  --data-urlencode "ip=203.0.113.7" \
  -d categories=18,22 \
  --data-urlencode "comment=SSH login attempts" \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "203.0.113.7", "abuseConfidenceScore": 12}}

Python · requests

import requests

r = requests.get(
    "https://ip-db.com/api/v2/check",          # was https://api.abuseipdb.com/api/v2/check
    params={"ipAddress": "185.220.101.1", "maxAgeInDays": 90},
    headers={"Key": "YOUR_IPDB_KEY", "Accept": "application/json"},
    timeout=10,
)
score = r.json()["data"]["abuseConfidenceScore"]

fail2ban: reportar lo que bloquea

# /etc/fail2ban/action.d/ipdb.conf
[Definition]
norestored = 1
actionstart =
actionstop =
actioncheck =
actionban = curl -sSf "https://ip-db.com/api/v2/report" -H "Accept: application/json" -H "Key: <ipdb_apikey>" --data-urlencode "comment=fail2ban: <name>" --data-urlencode "ip=<ip>" --data "categories=<ipdb_category>"
actionunban =

[Init]
ipdb_apikey =
ipdb_category = 18

# /etc/fail2ban/jail.local
[sshd]
enabled = true
action = %(action_)s
         ipdb[ipdb_apikey="YOUR_IPDB_KEY", ipdb_category="18,22"]

# sudo fail2ban-client reload
Guarde el archivo, añádalo al jail y recargue fail2ban. No hace falta quitar su acción de AbuseIPDB; ambas funcionan a la vez. El comentario no lleva líneas de log a propósito: pueden contener nombres de host o de usuario.

Lo que coincide exactamente

RutasGET /api/v2/check y POST /api/v2/report
ParámetrosipAddress, maxAgeInDays, verbose; ip, categories, comment
Autenticaciónla cabecera Key
Envoltorio{"data": …} y {"errors": [{detail, status}]}
Nombres de campoabuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt…
Códigos de estado401, 422, 429
CabecerasX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After
Categorías de reportese aceptan los identificadores numéricos de AbuseIPDB (p. ej. 18,22)
La misma dirección puede reportarse una vez cada 15 minutos

Lo que cambia

Lo compatible es el formato, no los datos. Lo que conviene saber antes de cambiar:

La puntuación es la nuestraabuseConfidenceScore usa la misma escala 0–100, pero se calcula con 44 listas de amenazas, reportes de la comunidad y registros DNSBL. No coincidirá con la cifra de AbuseIPDB; observe su umbral (por ejemplo 75) unos días y ajústelo.
maxAgeInDays no cambia la respuestaEl parámetro se valida (1–365), pero la puntuación refleja siempre los listados actuales.
verbose no devuelve la lista de reportesSe añade countryName; reports es siempre una lista vacía. No entregamos reportes individuales por la API.
hostnames está vacíoEl DNS inverso no forma parte de esta respuesta.
Dos categorías sin equivalente13 (VPN IP) y 17 (Spoofing) no existen aquí; un reporte que solo lleve esas se rechaza con 422.
Solo check y reportblacklist, check-block, bulk-report y clear-address no se ofrecen en /api/v2. Para una lista de bloqueo use /api/v1/feed.txt.
Los extras van en data.ipdbListas de origen, tipo de red, ASN, contacto de abuso RDAP y la página pública de la dirección. Un cliente escrito para AbuseIPDB nunca mira ahí.

Límites diarios

CuentaConsultas / díaReportes / díaPrecio
IP-DB, cuenta nueva1.0001.000Gratis
IP-DB, correo verificado10.00010.000Gratis
IP-DB, colaborador (ejecuta un sensor o Shield)30.00030.000Gratis
AbuseIPDB, gratis (Individual)1,0001,000Gratis
La fila de AbuseIPDB se tomó de sus propias páginas de precios y documentación el 16 de noviembre de 2026; consulte allí el valor actual. En IP-DB las consultas y los reportes se cuentan por separado, y /api/v1 y /api/v2 usan el mismo contador. El límite se reinicia a medianoche, hora local. Si necesita más, escríbanos; lo ampliamos sin coste.

Empiece en un minuto

Cree una cuenta, verifique su correo y genere una clave en el panel. Para todos los campos de nuestra propia API y el feed de bloqueo, consulte la documentación.

Obtener clave gratis Documentación de la API Guías de integración

Preguntas frecuentes

¿Funciona aquí mi clave de AbuseIPDB?
No. Las claves son de cada servicio; la clave de IP-DB se obtiene gratis en el panel de la cuenta y se envía igual, en la cabecera Key.
¿Las puntuaciones coinciden con las de AbuseIPDB?
No. La escala es la misma (0–100), pero el cálculo no: la puntuación de IP-DB se construye con 44 listas de amenazas, reportes de la comunidad y registros DNSBL. Observe su umbral unos días y ajústelo.
¿Puedo usar ambos a la vez?
Sí. fail2ban puede ejecutar más de una acción en un jail y un script puede consultar las dos fuentes. Si agota el límite de un servicio, el otro sigue respondiendo.
¿Tiene algún coste?
No. IP-DB es un servicio gratuito de interés público, sin planes de pago. Una cuenta verificada tiene 10.000 consultas al día; se amplía gratis a petición.
¿/api/v1 y /api/v2 tienen cuotas separadas?
No, comparten un contador diario. Los reportes se cuentan aparte de las consultas, así que reportar no gasta sus consultas.

AbuseIPDB es una marca de su titular. IP-DB es un servicio independiente, sin relación ni aval de AbuseIPDB.