People search
Request example
/api/v1/search- Scope
search- Formats
- JSON · SSE
- Sandbox
- Free fixtures
Body parameters
querystringrequiredThe name, phone number, email address, or username to look up.
typeenumHow to interpret the query.
namephoneemailusernameDefault: name
platformsstring | string[]For a username search, narrow discovery to supported focus platforms (e.g. instagram, x, linkedin). Ignored for other types.
formatenumsse streams Server-Sent Events as results arrive; json collects every event and returns one object.
ssejsonDefault: sse
sandboxbooleanReturn deterministic, unmetered fixtures for CI, demos, and parser development.
Default: false
Response
JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.
Sources & coverage
Submit an identifier and stream back ranked candidate matches (PersonHit objects) drawn from public sources. Each candidate carries a confidence score and descriptive tags so you can disambiguate before requesting a full dossier.
Usage & caching
Standard search is Medium usage. Cached results and idempotent replays use no usage.
Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.