Introduction
Welcome to the Seekr API documentation. Our API allows you to programmatically access our OSINT tools, breach databases, and ULP (URL:Login:Password) records.
https://seekr.to/api/v1application/jsonJSON / SSEAuthentication
Authenticate your requests by including your API key in the Authorization header. You can generate and manage your API keys in the Dashboard settings.
Authorization: Bearer YOUR_API_KEYKeep your API keys secure. Do not share them in client-side code (browsers, mobile apps).
Username Search
Perform a real-time OSINT scan across 80+ platforms for a specific username. This endpoint streams results using Server-Sent Events (SSE) due to the long-running nature of the scan.
/searchSearch Username
Initiates a username scan. Results are streamed as they are found.
| Name | Type | Required | Description |
|---|---|---|---|
| username | string | Yes | The username to search for (e.g. 'johndoe') |
| categories | array | No | Filter by categories (e.g. ['social', 'gaming']) |
curl -X POST https://seekr.to/api/v1/search \
-H "Authorization: Bearer $KEY" \
-H "Accept: text/event-stream" \
-H "Content-Type: application/json" \
-d '{"username": "johndoe"}'Database Search
Search through our indexed breach databases. This endpoint returns JSON results immediately.
/database/searchSearch Breaches
Search for records by email, username, IP, or other identifiers.
| Name | Type | Required | Description |
|---|---|---|---|
| term | string | Yes | Search term (min 2 chars) |
| type | string | Yes | One of: email, username, password, hash, ip, name, lastip |
| wildcard | boolean | No | Enable wildcard matching (default: false) |
curl -X POST https://seekr.to/api/v1/database/search \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{
"term": "[email protected]",
"type": "email",
"wildcard": false
}'/database/statsGet Statistics
Retrieve current statistics about the indexed databases.
curl https://seekr.to/api/v1/database/stats \
-H "Authorization: Bearer $KEY"ULP Search
Search the URL:Login:Password (ULP) database. This dataset is optimized for finding credentials associated with specific URLs or logins.
/ulp/searchSearch ULP Records
Advanced search with filtering options.
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search query (min 3 chars) |
| search_type | string | No | One of: url, login, password, all (default: all) |
| limit | integer | No | Max results (default: 100, max: 1000) |
| offset | integer | No | Pagination offset (default: 0) |
curl -X POST https://seekr.to/api/v1/ulp/search \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "netflix.com",
"search_type": "url",
"limit": 10
}'Errors & Limits
Status Codes
| 200 | Request successful |
| 400 | Invalid parameters |
| 401 | Invalid API key |
| 402 | Insufficient credits |
| 429 | Rate limit exceeded |
Rate Limits
*Subject to fair use policy. API keys have separate rate limits visible in the dashboard.