Umstiegsanleitung · /api/v2

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.

Abfragen / Tag10.000bestätigtes Konto
Meldungen / Tag10.000eigener Zähler
Score-Basis44Threat-Feeds
PreisKostenloskeine Bezahltarife

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.

WasVorherNachher
Basis-URLhttps://api.abuseipdb.com/api/v2https://ip-db.com/api/v2
SchlüsselIhr AbuseIPDB-SchlüsselIhr IP-DB-Schlüssel (ipdb_…)
Ein AbuseIPDB-Schlüssel gilt hier nicht; einen IP-DB-Schlüssel gibt es in einer Minute im Konto-Panel. Nach Bestätigung Ihrer E-Mail steigt das Tageslimit von 1.000 auf 10.000.

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
Datei speichern, im Jail eintragen, fail2ban neu laden. Ihre bestehende AbuseIPDB-Aktion muss nicht entfernt werden; beide laufen nebeneinander. Der Kommentar enthält bewusst keine Logzeilen: darin können Hostnamen oder Benutzernamen stehen.

Was genau übereinstimmt

PfadeGET /api/v2/check und POST /api/v2/report
ParameteripAddress, maxAgeInDays, verbose; ip, categories, comment
Authentifizierungder Key-Header
Hülle{"data": …} und {"errors": [{detail, status}]}
FeldnamenabuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt…
Statuscodes401, 422, 429
HeaderX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After
Meldekategoriendie 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 ScoreabuseConfidenceScore 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 nichtDer Parameter wird geprüft (1–365), der Score spiegelt aber immer die aktuellen Listungen.
verbose liefert keine MeldelistecountryName kommt hinzu; reports ist immer eine leere Liste. Einzelne Meldungen geben wir nicht über die API heraus.
hostnames ist leerReverse DNS ist nicht Teil dieser Antwort.
Zwei Kategorien ohne Entsprechung13 (VPN IP) und 17 (Spoofing) gibt es hier nicht; eine Meldung nur mit diesen wird mit 422 abgelehnt.
Nur check und reportblacklist, 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.ipdbQuelllisten, Netztyp, ASN, RDAP-Abuse-Kontakt und die öffentliche Seite der Adresse. Ein für AbuseIPDB geschriebener Client schaut dort nie hin.

Tageslimits

KontoAbfragen / TagMeldungen / TagPreis
IP-DB, neues Konto1.0001.000Kostenlos
IP-DB, E-Mail bestätigt10.00010.000Kostenlos
IP-DB, Mitwirkende (Sensor oder Shield im Betrieb)30.00030.000Kostenlos
AbuseIPDB, kostenlos (Individual)1,0001,000Kostenlos
Die AbuseIPDB-Zeile stammt von deren eigenen Preis- und Dokumentationsseiten, Stand 16. November 2026; den aktuellen Wert finden Sie dort. Bei IP-DB werden Abfragen und Meldungen getrennt gezählt, /api/v1 und /api/v2 nutzen denselben Zähler. Das Limit wird um Mitternacht Ortszeit zurückgesetzt. Wenn Sie mehr brauchen, schreiben Sie uns; wir erhöhen es 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.

Kostenlosen Schlüssel holen API-Doku Integrationsanleitungen

Häufige Fragen

Funktioniert mein AbuseIPDB-Schlüssel hier?
Nein. Schlüssel gehören zum jeweiligen Dienst; einen IP-DB-Schlüssel gibt es kostenlos im Konto-Panel, gesendet wird er genauso im Key-Header.
Stimmen die Scores mit AbuseIPDB überein?
Nein. Die Skala ist gleich (0–100), die Berechnung nicht: Der IP-DB-Score entsteht aus 44 Threat-Feeds, Community-Meldungen und DNSBL-Einträgen. Beobachten Sie Ihren Schwellenwert einige Tage und passen Sie ihn an.
Kann ich beide gleichzeitig nutzen?
Ja. fail2ban kann in einem Jail mehrere Aktionen ausführen, und ein Skript kann beide Quellen abfragen. Ist das Limit des einen Dienstes erreicht, antwortet der andere weiter.
Kostet das etwas?
Nein. IP-DB ist ein kostenloser Dienst im öffentlichen Interesse ohne Bezahltarife. Ein bestätigtes Konto erhält 10.000 Abfragen pro Tag; mehr gibt es auf Anfrage kostenlos.
Haben /api/v1 und /api/v2 getrennte Kontingente?
Nein, sie teilen sich einen Tageszähler. Meldungen werden getrennt von Abfragen gezählt und verbrauchen keine Abfragen.

AbuseIPDB ist eine Marke ihres Inhabers. IP-DB ist ein unabhängiger Dienst und steht in keiner Verbindung zu AbuseIPDB.