Search Advanced

Export leaks to CSV/TXT/JSON

Queue an export of all leaks that match the provided advanced search filters. At least one filter is required.

Request body

  • JSON payload following the LeakSearchFilters schema.

Query parameters

  • format optional output format: csv (default), txt, or json.

Limits and plan requirement

  • You can have at most 5 exports with status PENDING or IN_PROGRESS per account.
  • Requires a paid plan with advanced_search enabled.

Response ExportResponse with status, message, and export_id.

post/search/advanced/export

Query parameters

format'csv' | 'txt' | 'json'

Output format: csv (default), txt, or json.

Request body

usernamestring[] nullable

Username values to match.

username_notstring[] nullable

Username values to exclude.

username_match_type'contains' | 'starts_with' | 'ends_with'
username_not_match_type'contains' | 'starts_with' | 'ends_with'
passwordstring[] nullable

Password values to match.

password_notstring[] nullable

Password values to exclude.

password_match_type'contains' | 'starts_with' | 'ends_with'
password_not_match_type'contains' | 'starts_with' | 'ends_with'
urlstring[] nullable

URL values to match.

url_notstring[] nullable

URL values to exclude.

url_match_type'contains' | 'starts_with' | 'ends_with'
url_not_match_type'contains' | 'starts_with' | 'ends_with'
url_domainstring[] nullable

URL domain values to match.

url_domain_notstring[] nullable

URL domain values to exclude.

url_domain_match_type'contains' | 'starts_with' | 'ends_with'
url_domain_not_match_type'contains' | 'starts_with' | 'ends_with'
url_hoststring[] nullable

URL host values to match.

url_host_notstring[] nullable

URL host values to exclude.

url_host_match_type'contains' | 'starts_with' | 'ends_with'
url_host_not_match_type'contains' | 'starts_with' | 'ends_with'
username_hashstring[] nullable

Username SHA-1 hash prefix (hex).

password_hashstring[] nullable

Password SHA-1 hash prefix (hex).

url_schemestring[] nullable

URL scheme(s) to include (multi).

url_scheme_notstring[] nullable

URL scheme(s) to exclude (multi).

url_portinteger[] nullable

URL port(s) to include (multi).

url_port_notinteger[] nullable

URL port(s) to exclude (multi).

url_tldstring[] nullable

URL TLD(s) to include (multi).

url_tld_notstring[] nullable

URL TLD(s) to exclude (multi).

is_emailboolean nullable

Identifier type filter: true=email only, false=username only, null=both.

email_domainstring[] nullable

Email domain values to match.

email_domain_notstring[] nullable

Email domain values to exclude.

email_domain_match_type'contains' | 'starts_with' | 'ends_with'
email_domain_not_match_type'contains' | 'starts_with' | 'ends_with'
email_hoststring[] nullable

Email host values to match.

email_host_notstring[] nullable

Email host values to exclude.

email_host_match_type'contains' | 'starts_with' | 'ends_with'
email_host_not_match_type'contains' | 'starts_with' | 'ends_with'
email_tldstring[] nullable

Email TLD(s) to include (multi).

email_tld_notstring[] nullable

Email TLD(s) to exclude (multi).

password_strength'too_weak' | 'weak' | 'medium' | 'strong'
added_fromstring date-time nullable

Only include leaks indexed on/after this UTC datetime.

added_tostring date-time nullable

Only include leaks indexed on/before this UTC datetime.

force_andboolean nullable

When true, require all values within each field (AND within field).

Example request

{
  "password": [
    "123456"
  ],
  "url_domain": [
    "example.com"
  ]
}

Response

Export queued successfully.

statusstring required

Export job status: 'queued', 'processing', 'completed', or 'failed'.

messagestring required

Human-readable status message.

export_idinteger required

ID of the export job. Use this to check status or download the result.

Example response

{
  "export_id": 1234,
  "message": "Your export request has been queued. Check the Exports page for progress.",
  "status": "queued"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.