Download API Logs Tutorial
This tutorial explains how to use the AbuseIPDB Download API Logs feature.
The feature allows you to download API logs in CSV format. If the file is large, it will be automatically compressed into a GZIP file for convenience.
When you start the download process, smaller files will download immediately. For larger files, the system then processes the request in the background. You will receive an email notification once the process begins, and after completion, you will receive a second email with a secure link to download the GZIP CSV file.
Using the tool:
- Select a Start Date and End Date using the date pickers. The dates are in UTC format.
- Choose the API endpoints you want to include in the logs (e.g.,
check,report,blacklist). - Click the Download button to retrieve your logs.
Note: Clicking the download button will automatically retrieve the maximum available range of logs.
Note: All date and time inputs are displayed in UTC format.
CSV File Preview
The CSV file you download will contain data formatted as follows:
| Client IP | API Key | Endpoint | Created At |
|---|---|---|---|
| 192.168.1.100 | abc123xyz | blacklist | 2025-02-15 14:32:00 |
| 192.168.1.101 | abc123xyz | check | 2025-02-15 14:33:10 |
| 192.168.1.102 | abc123xyz | report | 2025-02-15 14:35:05 |
The file will be saved with either a .csv extension for small files or a .csv.gz
extension for large files.
Example file names:
api_requests_{your email}@abuseipdb.com_{start date}_{end date}.csv
api_requests_{your email}@abuseipdb.com_{start date}_{end date}.csv.gz
Time Period Windows by Account Type
The available time window for downloading API logs depends on your account type. The table below summarizes the maximum lookback period for each account:
| Account Type | Maximum Lookback Period |
|---|---|
| Individual | 24 hours |
| Basic | 72 hours (3 days) |
| Premium | 120 hours (5 days) |
Note: You cannot select a start date earlier than your account's maximum lookback period.
Immediate Download vs. Mailed Link
Immediate Download: If your requested log file contains 10,000 rows or fewer (approximately 1–2 MB for typical log data), it will be downloaded directly in your browser.
Mailed Link: If your request would generate a file with more than 10,000 rows, the system will process your request in the background and email you a secure download link when it is ready.
How Long Is the Mailed Link Valid?
The secure download link sent to your email will be valid for 24 hours from the time it is generated. After that, you will need to request a new download if you need the file again.