1 Quick Start
Authentication
All API requests require an API Key for authentication. Your API Key is your account's password. Treat it as confidential.
Header
X-API-KEY
Recommended method. Include your API Key in the `X-API-KEY` header.
Query Parameter
api_key
Alternative method for quick testing. Include your API Key as `?api_key=YOUR_KEY` in the URL.
2 Endpoints
List Available Datasets
GETRetrieve a list of all available data files on the platform, including their metadata.
Resource URL
/api.php?endpoint=datasets/listParameters
| Key | Type | Requirement | Description |
|---|---|---|---|
limit |
integer | Optional | Maximum number of datasets to return. |
offset |
integer | Optional | Offset for pagination. |
Access & Limits
Free Plan
Limited to showing only the 1 latest dataset of each type.
Pro Plan
Full list of datasets.
Enterprise Plan
Full list of datasets.
Request
GET /api.php?endpoint=datasets/list&api_key=YOUR_PASSWORDResponse
{"total_results": 3, "limit": 100, "offset": 0, "datasets": [ {"type": "daily_ct_log", "name": "2025-07-30_domains.txt"} ]}Get Latest Domain Dumps
GETRetrieve the most recent daily domain dump from Certificate Transparency (CT) Logs.
Resource URL
/api.php?endpoint=domains/latestParameters
| Key | Type | Requirement | Description |
|---|---|---|---|
limit |
integer | Optional | Maximum number of domain lines to return. |
Access & Limits
Free Plan
Limited to 100 domain lines per request.
Pro Plan
Limited to 5000 domain lines per request.
Enterprise Plan
Unlimited domain lines per request.
Request
GET /api.php?endpoint=domains/latest&api_key=YOUR_PASSWORD&limit=50Response
{"domains": ["example.com", "sub.domain.net"]}Get Domains by Date
GETRetrieve domain data for a specific historical date.
Resource URL
/api.php?endpoint=domains/by-dateParameters
| Key | Type | Requirement | Description |
|---|---|---|---|
date |
string (YYYY-MM-DD) | Required | The specific date for retrieval. |
Access & Limits
Free Plan
Limited to data from the last 7 days only.
Pro Plan
Access to historical data up to 365 days.
Enterprise Plan
Unlimited historical data access.
Request
GET /api.php?endpoint=domains/by-date&date=2025-07-25&api_key=YOUR_PASSWORDResponse
{"domains": ["olddomain.org", "another.com"]}Get Domains by TLD
GETRetrieve domain data for a specific Top-Level Domain (TLD) extension.
Resource URL
/api.php?endpoint=domains/by-extensionParameters
| Key | Type | Requirement | Description |
|---|---|---|---|
extension |
string | Required | The TLD (e.g., com, org, id). |
Access & Limits
Free Plan
Limited to common TLDs (.com, .org, .net).
Pro Plan
Access to all available TLDs.
Enterprise Plan
Access to all available TLDs.
Request
GET /api.php?endpoint=domains/by-extension&extension=id&api_key=YOUR_PASSWORDResponse
{"domains": ["mywebsite.id", "blog.id"]}