Search

API documentation for performing searches using various parameters.

Base URL

The base URL for all API requests is:

https://osintleak.com/api/v1/

Endpoints

GET /search_api/

Performs a search based on the provided parameters.

Parameters

api_keyrequiredstring
Your API key.
queryrequiredstring
The search query.
typerequiredstring
The type of search. Available types are: name, first_name, last_name, email, username, password, logname, phone, idcard, cc_holder, cc_number, ftp, ip, url, subdomain, autofill_key, autofill_value.
stealerlogs'true' | 'false'
false
Whether to search stealer logs dataset.
dbleaks'true' | 'false'
false
Whether to search database leaks dataset.
dbleaks2'true' | 'false'
false
Whether to search database leaks 2 dataset.
search_option'quick' | 'similar'
quick
Whether to perform a quick search or a similar search.
from_datestring
The start date for the search in YYYY-MM-DD format.
to_datestring
The end date for the search in YYYY-MM-DD format.
countrystring
The country code to filter results.
pageinteger
1
The page number for pagination.
page_sizeinteger
20
The number of results per page.
sort'asc' | 'desc'
The sorting order of results.
meta'true' | 'false'
true
Whether to include metadata in the response.

Response:

  • 200 OK: Returns the search results.
  • 400 Bad Request: Missing parameters or bad request.
  • 403 Forbidden: Access denied.
  • 429 Too Many Requests: Rate limit exceeded.
  • Other status codes indicate an error.

Example Request:

curl -G "https://osintleak.com/api/v1/search_api/" \
     -H "User-Agent: OL-Python/1.0.2" \
     -d "api_key=your_api_key" \
     -d "[email protected]" \
     -d "type=email" \
     -d "stealerlogs=false" \
     -d "dbleaks=false" \
     -d "dbleaks2=false" \
     -d "search_option=quick" \
     -d "from_date=2022-01-01" \
     -d "to_date=2022-12-31" \
     -d "country=US" \
     -d "page=1" \
     -d "page_size=20" \
     -d "sort=asc" \
     -d "meta=true"

Example Response:

{
  "status": "success",
  "results": [...],
  "count": 999,
  "page": 1,
  "total_page": 99,
  "search_title": "QS:[email protected]:email",
  "result_id": "b1a86fff-b95c-29f1-a9d9-ae9a3d7a18a1",
  "sl_limited": false,
  "cached": "no",
  "censored": false
}

In case of an error:

{
    "status": "error",
    "message": "...",
    "results": []
}

Error Responses

Quota Exceeded (403 Forbidden)

When you reach daily usage limits, the API returns a 403 Forbidden status with one of these messages:

API quota exceeded:

{"status": "error", "message": "API quota exceeded"}

Search category quota exceeded (e.g., email, phone, username):

{"status": "error", "message": "{Quota Category} quota exceeded"}

Similar search quota exceeded:

{"status": "error", "message": "Similar search quota exceeded"}

Subscription Expired (403 Forbidden)

For enterprise users:

{"status": "error", "message": "Organization subscription expired"}

For other subscription types:

{"status": "error", "message": "Subscription expired"}
Authentication
This guide will help you get started with generating an API key and configuring IP whitelisting for secure access.
Overview
Osintleak SDK Overview