Skip to main content
AbuseIPDB logo
  • Category: security & identity tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 6
  • Triggers: 0
  • Slug: ABUSELPDB
  • Version: 20261101_00

Tools

Slug: ABUSELPDB_BLACKLISTRetrieves a list of the most reported malicious IP addresses from AbuseIPDB’s database. Use this tool to build dynamic blocklists, threat intelligence feeds, or firewall rules. The blacklist is updated hourly and contains IPs with high abuse confidence scores. Free accounts receive up to 10,000 IPs. Paid subscriptions unlock filtering options (confidenceMinimum, country filters) and higher limits (up to 500,000 IPs).

Input Parameters

integer
Maximum number of IP addresses to return. Free accounts are limited to 10,000 IPs. Paid plans allow up to 100,000 or 500,000 depending on tier.
integer ("4" | "6")
Filter by IP version: 4 for IPv4 addresses only, 6 for IPv6 addresses only. Omit to include both.
string
Comma-separated ISO 3166-1 alpha-2 country codes to include (e.g., ‘US,CA,MX’). Only IPs from these countries are returned. Requires a paid subscription.
string
Comma-separated ISO 3166-1 alpha-2 country codes to exclude (e.g., ‘CN,RU’). IPs from these countries are filtered out. Requires a paid subscription.
integer
Minimum abuse confidence score (25-100) to filter reported IPs. Only IPs with scores at or above this threshold are returned. Requires a paid subscription.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ABUSELPDB_BULK_REPORTSubmit multiple IP abuse reports to AbuseIPDB in bulk via CSV upload. Use this when you need to report many malicious IPs at once instead of one-by-one. Returns the count of successfully saved reports and details about any invalid entries.

Input Parameters

string
required
CSV content containing IP abuse reports. Must include headers: IP, Categories, ReportDate, Comment. IP: Valid IPv4 or IPv6 address. Categories: Comma-separated category IDs (e.g., ‘18,22’ for SSH abuse). Common categories: 3=Fraud Orders, 4=DDoS Attack, 5=FTP Brute-Force, 6=Ping of Death, 7=Phishing, 10=Email Spam, 11=Blog Spam, 14=Port Scan, 18=Brute-Force, 19=Bad Web Bot, 21=Web Spam, 22=SSH, 23=IoT Targeted. ReportDate: ISO 8601 format recommended (e.g., ‘2024-01-15T10:00:00-05:00’). Comment: Description of the attack (max 1024 characters). Limit: 10,000 rows max, 8MB max file size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ABUSELPDB_CHECK_BLOCKCheck a CIDR network block for abuse data, including details of reported IP addresses and network information. Available network ranges and report look-back periods depend on the subscription plan.

Input Parameters

string
required
IPv4 network in CIDR notation (e.g., ‘192.168.1.0/24’). Free plans only support /24 networks; paid plans may use wider ranges up to /16.
integer
Number of days back to include abuse reports (1-365). Free plans are limited to 30 days max. Defaults to 30.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ABUSELPDB_CHECK_IPTool to check the reputation of an IP address. Use when you need to determine if an IP address has been reported for abusive activity within a specified look-back period. Example: CheckIp(ipAddress=‘8.8.8.8’, maxAgeInDays=90).

Input Parameters

boolean
When true, includes detailed abuse reports with comments, categories, and reporter information.
string
required
IP address (IPv4 or IPv6) to check for abuse reports.
integer
Look-back period for reports in days (default=30, max=365).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ABUSELPDB_CLEAR_ADDRESSRemove reports from your AbuseIPDB account for a specific IP address.

Input Parameters

string
required
A valid IPv4 or IPv6 address whose reports will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ABUSELPDB_GET_REPORTSRetrieve paginated abuse reports for a specific IP address from AbuseIPDB, including categories, reporter details, and timestamps. Reports are limited to a look-back period, which defaults to 30 days.

Input Parameters

integer
Page number for pagination (1-indexed). Default is 1.
integer
Number of reports to return per page (1-100). Default is 25.
string
required
IPv4 or IPv6 address to retrieve reports for
integer
Only return reports from the last N days (1-365). Default is 30 days.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not