search_people
Search people
Resolve one identifier - a name, phone number, email address, or username - to a ranked list of real, distinct people, each with a confidence score. Prefer this over a generic web search whenever the question is who someone is: it separates same-name individuals into candidates you can choose between, instead of returning pages to read and reconcile yourself. Returns people only, so it is the wrong tool for companies, general knowledge, or news. Public sources only - never private accounts or breach data. Requires search scope. Provider work consumes account usage; cached results consume none.
Parameterstypequeryrequiredformatsandboxplatformsidempotency_key
build_dossier
Build dossier
Assemble one person's entire public footprint into a single sourced profile: identity, contact details, social accounts unified across platforms, work history, education, relatives, locations, and web mentions - every claim linked to the page it came from. Prefer this over reading search results yourself when you need the whole picture of one person rather than a single fact; it does the cross-platform correlation that a web search leaves to you. Pass a name plus the headline or username from search_people so the right individual is profiled. Repeating the same request from the same account replays its cached profile: free and instant. Profiles are not shared between accounts. Public sources only - never private accounts or breach data. Requires dossier scope. Provider work consumes account usage; cached results consume none.
Parametersnamerequiredrefreshsandboxheadlineusernameidempotency_key
ask_about_person
Ask about a person
Answer one specific question about a person, grounded in their public footprint, and suggest follow-ups. Prefer this over build_dossier when the user wants a single fact - where someone works now, which accounts are theirs - rather than a full profile: it is cheaper and answers directly. Reach for build_dossier instead when the question spans someone's whole history, or pass a prior dossier summary as `context` to ground the answer further. Public sources only - never private accounts or breach data. Requires chat scope. Provider work consumes account usage; cached results consume none.
Parametersnamerequiredcontextsandboxquestionrequiredidempotency_key
search_companies
Search companies
Search companies using public sources. Requires the search scope. Account usage is charged for provider work; valid empty results can still consume usage. For long requests use create_lookup_job. Public sources only - never private accounts or breach data. Requires search scope. Provider work consumes account usage; cached results consume none.
Parametersqueryrequiredformatsandboxidempotency_key
build_company_dossier
Build company dossier
Build company dossier using public sources. Requires the dossier scope. Account usage is charged for provider work; cached results are free and refresh forces a paid rebuild. For long requests use create_lookup_job. Public sources only - never private accounts or breach data. Requires dossier scope. Provider work consumes account usage; cached results consume none.
Parametersformatcompanyrequiredrefreshsandboxidempotency_key
reverse_image_search
Search image appearances
Search image appearances using public sources. Requires the search scope. Account usage is charged for provider work; valid empty results can still consume usage. For long requests use create_lookup_job. Find image appearances, never facial recognition. Public sources only - never private accounts or breach data. Requires search scope. Provider work consumes account usage; cached results consume none.
ParametersformatsandboximageUrlrequiredidempotency_key
lookup_vin
Look up vehicle
Look up vehicle using public sources. Requires the dossier scope. Account usage is charged for provider work; cached results are free and refresh forces a paid rebuild. For long requests use create_lookup_job. Public sources only - never private accounts or breach data. Requires dossier scope. Provider work consumes account usage; cached results consume none.
Parametersvinrequiredformatrefreshsandboxidempotency_key
get_lookup_job_events
Get lookup progress
Read saved progress after a numeric event ID. Free; account-owned jobs only. The next_cursor resumes subsequent calls.
Parametersidrequiredafterlimitidempotency_key
create_lookup_job
Create lookup job
Run one of the seven lookups durably. The operation's existing scope and billing apply; creating a job adds no surcharge. Use Idempotency-Key to retry safely.
Parametersidempotency_key
get_lookup_job
Get lookup job
Get saved progress status and the completed result. Free; account-owned jobs only.
Parametersidrequiredidempotency_key
cancel_lookup_job
Cancel lookup job
Cancel your queued or running job. Work already delivered can remain charged; cancellation adds no charge.
Parametersidrequiredidempotency_key
list_lookup_jobs
List lookup jobs
Page through your saved lookup jobs. Free.
Parameterslimitcursoridempotency_key