Abuseipdb API

AbuseIPDB API v2

Base URL

https://api.abuseipdb.com/api/v2

Authentication

Header: Key: $ABUSEIPDB_API_KEY Also: Accept: application/json

Rate Limits

• Free: 1000 checks/day, 500 reports/day
• Premium: Higher limits

Key Endpoints

Check IP

curl -s "https://api.abuseipdb.com/api/v2/check" \
  -G -d "ipAddress={ip}" -d "maxAgeInDays=90" -d "verbose" \
  -H "Key: $ABUSEIPDB_API_KEY" -H "Accept: application/json"

Useful fields:

• data.abuseConfidenceScore — 0-100 abuse confidence
• data.totalReports — number of abuse reports
• data.numDistinctUsers — unique reporters
• data.lastReportedAt — most recent report
• data.isp — ISP name
• data.usageType — usage type (Data Center, ISP, etc.)
• data.countryCode — country
• data.domain — associated domain
• data.isTor — Tor exit node flag
• data.reports[] — individual reports (with verbose)

Check Network (CIDR)

curl -s "https://api.abuseipdb.com/api/v2/check-block" \
  -G -d "network={cidr}" -d "maxAgeInDays=90" \
  -H "Key: $ABUSEIPDB_API_KEY" -H "Accept: application/json"

Confidence Score Interpretation

Response Summary Format

ip: <IP>
abuse_confidence: <0-100>
total_reports: <number>
distinct_reporters: <number>
last_reported: <date>
isp: <ISP>
usage_type: <type>
country: <country>
is_tor: <true/false>
verdict: clean|low-risk|suspicious|malicious