Request
POST /v1/search/advanced · Required scope: search:advanced (pro and ultra tiers)
At least one of domains, emails, ips, pc_names, stealer_family, or
country is required. All provided filters are AND-combined.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domains | string[] | No* | [] | Registrable domains to filter by |
emails | string[] | No* | [] | Email addresses to filter by |
ips | string[] | No* | [] | IPv4 addresses to filter by |
pc_names | string[] | No* | [] | Computer names to filter by |
stealer_family | string | null | No* | — | Stealer family name, e.g. "RedLine", "LummaC2" |
country | string | null | No* | — | ISO 3166-1 alpha-2 country code, e.g. "US", "DE" |
start_date | string (date-time) | null | No | — | Inclusive start filter, clamped by query_window_days |
end_date | string (date-time) | null | No | — | Inclusive end filter |
sort_direction | asc | desc | No | desc | Must stay constant across pages |
cursor | string | null | No | — | Pagination token |
limit | integer | No | 25 | 1–500, clamped to your tier’s max_rows |
domains, emails, ips, pc_names, stealer_family,
or country must be provided.
Example request
Response
200 OK — array of AdvancedSearchResult, cursor-paginated.
| Field | Description |
|---|---|
stealer_id | log_victim_id of the infected machine |
victim_id | SHA-256 victim ID — use with Victim Profiles |
username | Account identifier from the stolen credential record |
password | Plaintext stolen password |
domain | Registrable domain extracted from url |
url | Login URL from the stolen credential record |
infection_date | When the log was captured |
Pagination
Cursor-paginated — see Pagination.Errors
| Status | code | Cause |
|---|---|---|
| 400 | VALIDATION_ERROR | None of domains/emails/ips/pc_names/stealer_family/country provided |
| 400 | INVALID_CURSOR | Tampered or stale cursor |
| 403 | FORBIDDEN_SCOPE | Key lacks search:advanced (free tier) |
Tier notes
This endpoint requiressearch:advanced, which is not included on the
free tier — a free-tier key receives 403 FORBIDDEN_SCOPE. Both pro and
ultra tiers receive username, password, and url unmasked — the
free-tier masking rules in Data Masking for these fields
never apply here, since free tier cannot call this endpoint at all.