Skip to main content
find people
The assistant tool is find_people. On the published plan for new signups, a page with at least one person costs 1 credit. An empty or failed page costs zero. Bounded results support name/query, employer name or canonical company ID, title, country and skill. Employer/title predicates apply to the same reported current role. Seniority and function evaluate current reported roles on this bounded page; inspect result_scope.scope, not a global filtered total. scope is indexed or bounded_shortlist. mode remains: provider_index is indexed. Results provide canonical person IDs and employer IDs/domains where available, so people-first research can continue to company profiles. Names without a canonical reference remain reported names, not independently resolved employers. At most 25 results/page, offset 1000, 60 account requests/minute. A failed search is not evidence of no matching professionals or current-employment verification.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer dl_live_<64 lowercase hexadecimal characters>. Signed-in users can create account-scoped, revocable keys in the Datalayer dashboard. A key does not grant credits. Dashboard session cookies are not API credentials.

Headers

Idempotency-Key
string

Recommended for every paid operation. Account-scoped and bound to normalized operation/input. Retry exactly the same key after transport loss: a committed credit result is replayed from persisted normalized bytes without a data lookup or another debit. Changed input, key expiry or paid-anchor expiry returns 409. In-flight requests return request_in_progress. Network delivery and D1 commit are not atomic. If omitted a request ID is created.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json
query
string
required
Required string length: 1 - 200
name
string
Required string length: 1 - 200
company
string
Required string length: 1 - 200
company_id
string
Pattern: ^[1-9][0-9]{0,19}$
title
string
Required string length: 1 - 200
country
string
Pattern: ^[A-Z]{2}$
skill
string
Required string length: 1 - 200
seniority
string
Required string length: 1 - 200
function
string
Required string length: 1 - 200
limit
integer
default:10

Advanced: how many matches to return on this page, from 1 to 25. Defaults to 10.

Required range: 1 <= x <= 25
offset
integer
default:0

Advanced: how many matches to skip before this page, from 0 to 1000. Defaults to 0.

Required range: 0 <= x <= 1000
max_credits
integer

Advanced: highest number of credits this call may spend. The call is refused before any lookup when the estimate is higher.

Required range: 0 <= x <= 3
dry_run
boolean

Advanced: return the maximum credit estimate without looking up data.

Response

A settled result or a maximum estimate with no data lookup.

data
object
required
meta
object
required