AbuseIPDB-kompatible API
Wenn Ihr Werkzeug bereits AbuseIPDB APIv2 spricht, müssen Sie keinen Code umschreiben. Basis-URL und Schlüssel ändern: gleiche Anfrage, gleiche Feldnamen, gleiches Fehlerformat. Ein Ausweg für Server, die ständig ans Tageslimit stoßen, oder einfach eine zweite Meinung.
Zwei Dinge ändern
Suchen Sie Adresse und Schlüssel von AbuseIPDB in den Einstellungen oder im Skript Ihres Werkzeugs und ersetzen Sie beide. Pfad (/api/v2/…), Parameter und Key-Header bleiben unverändert.
| Was | Vorher | Nachher |
|---|---|---|
| Basis-URL | https://api.abuseipdb.com/api/v2 | https://ip-db.com/api/v2 |
| Schlüssel | Ihr AbuseIPDB-Schlüssel | Ihr IP-DB-Schlüssel (ipdb_…) |
Fertige Beispiele
Adresse abfragen · 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": […], …}}}
Adresse melden · 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: Sperren melden
# /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
Was genau übereinstimmt
| Pfade | GET /api/v2/check und POST /api/v2/report |
| Parameter | ipAddress, maxAgeInDays, verbose; ip, categories, comment |
| Authentifizierung | der Key-Header |
| Hülle | {"data": …} und {"errors": [{detail, status}]} |
| Feldnamen | abuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt… |
| Statuscodes | 401, 422, 429 |
| Header | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After |
| Meldekategorien | die numerischen IDs von AbuseIPDB (z. B. 18,22) werden akzeptiert |
| Dieselbe Adresse kann einmal in 15 Minuten gemeldet werden | |
Was anders ist
Kompatibel ist das Format, nicht der Datenbestand. Was Sie vor dem Umstieg wissen sollten:
| Der Score ist unser Score | abuseConfidenceScore liegt auf derselben Skala 0–100, wird aber aus 44 Threat-Feeds, Community-Meldungen und DNSBL-Einträgen berechnet. Er entspricht nicht der Zahl von AbuseIPDB; beobachten Sie Ihren Schwellenwert (etwa 75) einige Tage und passen Sie ihn an. |
| maxAgeInDays ändert die Antwort nicht | Der Parameter wird geprüft (1–365), der Score spiegelt aber immer die aktuellen Listungen. |
| verbose liefert keine Meldeliste | countryName kommt hinzu; reports ist immer eine leere Liste. Einzelne Meldungen geben wir nicht über die API heraus. |
| hostnames ist leer | Reverse DNS ist nicht Teil dieser Antwort. |
| Zwei Kategorien ohne Entsprechung | 13 (VPN IP) und 17 (Spoofing) gibt es hier nicht; eine Meldung nur mit diesen wird mit 422 abgelehnt. |
| Nur check und report | blacklist, check-block, bulk-report und clear-address gibt es unter /api/v2 nicht. Für eine Sperrliste nutzen Sie /api/v1/feed.txt. |
| Extras stehen unter data.ipdb | Quelllisten, Netztyp, ASN, RDAP-Abuse-Kontakt und die öffentliche Seite der Adresse. Ein für AbuseIPDB geschriebener Client schaut dort nie hin. |
Tageslimits
| Konto | Abfragen / Tag | Meldungen / Tag | Preis |
|---|---|---|---|
| IP-DB, neues Konto | 1.000 | 1.000 | Kostenlos |
| IP-DB, E-Mail bestätigt | 10.000 | 10.000 | Kostenlos |
| IP-DB, Mitwirkende (Sensor oder Shield im Betrieb) | 30.000 | 30.000 | Kostenlos |
| AbuseIPDB, kostenlos (Individual) | 1,000 | 1,000 | Kostenlos |
In einer Minute startklar
Konto anlegen, E-Mail bestätigen, im Panel einen Schlüssel erzeugen. Alle Felder unserer eigenen API und den Sperrlisten-Feed finden Sie in der Doku.
Häufige Fragen
Funktioniert mein AbuseIPDB-Schlüssel hier?
Stimmen die Scores mit AbuseIPDB überein?
Kann ich beide gleichzeitig nutzen?
Kostet das etwas?
Haben /api/v1 und /api/v2 getrennte Kontingente?
AbuseIPDB ist eine Marke ihres Inhabers. IP-DB ist ein unabhängiger Dienst und steht in keiner Verbindung zu AbuseIPDB.