Request
POST /v1/search/infection-analysis · Required scope: infection-analysis (ultra tier only) · Not paginated
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
stealer | string | Yes | — | Stealer family name, e.g. "RedLine", "Raccoon", "Vidar", "LummaC2" |
agg_per_min limit — see Rate Limits & Tiers.
Example request
Response
200 OK — a single InfectionAnalysisResult object. nextCursor is not
present — this endpoint is not paginated.
| Field | Description |
|---|---|
likely_infection_url | URL heuristically identified as the infection vector, or null if no consistent pattern was found |
infection_reasoning | Human-readable explanation of why this URL was flagged |
infection_flow | Ordered sequence of browser-history events leading to the likely infection point |
analyst_summary | Narrative summary suitable for an incident report |
Not paginated
This endpoint always returns a single object.cursor/limit/sort_direction
do not apply.
Errors
| Status | code | Cause |
|---|---|---|
| 400 | VALIDATION_ERROR | stealer is missing |
| 403 | FORBIDDEN_SCOPE | Key lacks infection-analysis (free and pro tiers) |
| 429 | RATE_LIMIT_EXCEEDED | Exceeded your tier’s agg_per_min |
Tier notes
infection-analysis is part of ALL_SCOPES but only granted to the ultra
tier — free and pro keys receive 403 FORBIDDEN_SCOPE regardless of the
stealer value supplied. This endpoint can take noticeably longer than
standard search endpoints (often 1–2 seconds) because it invokes the
underlying AI model.