People · Search

Find people across the Spotium dataset by title, seniority, location, or company domain.

POST/v1/people/search1 credit per call

Body parameters

query
string
Free-text search query.
titles
string[]
seniorities
"owner" | "founder" | "c_suite" | "partner" | "vp" | "head" | "director" | "manager" | "senior" | "entry" | "intern"[]
locations
string[]
companyDomains
string[]

Response fields

Root

results
object[]required
source
"crm" | "data_source_1" | "web" | "none"required
Which cascade stage produced the returned results. `none` means every stage ran and returned zero hits.
debug
object
Diagnostics from the cascade run.
request_id
stringrequired

response.results[]

id
string
name
string
headline
string
Short one-line context, e.g. "Head of Fleet · DHL · Bonn, Germany".
linkedin_url
string
email
string
Only returned for CRM hits.
company
string
Primary company name — only returned for CRM hits.
company_domain
string
Primary company domain — only returned for CRM hits.
source
"crm" | "data_source_1" | "web"
Origin of this individual result. Matches the top-level `source` for every item in a given response.

response.debug

stage_hits
object
Hit count for each stage that was executed. Stages after the first hit are not run and are absent from this map.