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.
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é | Antes | Después |
|---|---|---|
| URL base | https://api.abuseipdb.com/api/v2 | https://ip-db.com/api/v2 |
| Clave | su clave de AbuseIPDB | su clave de IP-DB (ipdb_…) |
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
Lo que coincide exactamente
| Rutas | GET /api/v2/check y POST /api/v2/report |
| Parámetros | ipAddress, maxAgeInDays, verbose; ip, categories, comment |
| Autenticación | la cabecera Key |
| Envoltorio | {"data": …} y {"errors": [{detail, status}]} |
| Nombres de campo | abuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt… |
| Códigos de estado | 401, 422, 429 |
| Cabeceras | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After |
| Categorías de reporte | se 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 nuestra | abuseConfidenceScore 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 respuesta | El parámetro se valida (1–365), pero la puntuación refleja siempre los listados actuales. |
| verbose no devuelve la lista de reportes | Se añade countryName; reports es siempre una lista vacía. No entregamos reportes individuales por la API. |
| hostnames está vacío | El DNS inverso no forma parte de esta respuesta. |
| Dos categorías sin equivalente | 13 (VPN IP) y 17 (Spoofing) no existen aquí; un reporte que solo lleve esas se rechaza con 422. |
| Solo check y report | blacklist, 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.ipdb | Listas 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
| Cuenta | Consultas / día | Reportes / día | Precio |
|---|---|---|---|
| IP-DB, cuenta nueva | 1.000 | 1.000 | Gratis |
| IP-DB, correo verificado | 10.000 | 10.000 | Gratis |
| IP-DB, colaborador (ejecuta un sensor o Shield) | 30.000 | 30.000 | Gratis |
| AbuseIPDB, gratis (Individual) | 1,000 | 1,000 | Gratis |
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.
Preguntas frecuentes
¿Funciona aquí mi clave de AbuseIPDB?
¿Las puntuaciones coinciden con las de AbuseIPDB?
¿Puedo usar ambos a la vez?
¿Tiene algún coste?
¿/api/v1 y /api/v2 tienen cuotas separadas?
AbuseIPDB es una marca de su titular. IP-DB es un servicio independiente, sin relación ni aval de AbuseIPDB.