find people
curl --request POST \
--url https://api.datalayer.so/v1/people/find \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"name": "<string>",
"company": "<string>",
"company_id": "<string>",
"title": "<string>",
"country": "<string>",
"skill": "<string>",
"seniority": "<string>",
"function": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/people/find"
payload = {
"query": "<string>",
"name": "<string>",
"company": "<string>",
"company_id": "<string>",
"title": "<string>",
"country": "<string>",
"skill": "<string>",
"seniority": "<string>",
"function": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
name: '<string>',
company: '<string>',
company_id: '<string>',
title: '<string>',
country: '<string>',
skill: '<string>',
seniority: '<string>',
function: '<string>',
limit: 10,
offset: 0,
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/people/find', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"offset": 4503599627370495,
"limit": 13,
"next_offset": -4503599627369996,
"result_scope": {
"mode": "bounded_shortlist",
"evaluated": 12,
"exhaustive": false,
"scope": "bounded_shortlist",
"filters_applied_to": "<string>",
"provider_total": 4503599627370495,
"indexed_total": 4503599627370495
},
"coverage_note": "<string>",
"total": {
"value": 4503599627370495,
"relation": "eq"
},
"results": [
{
"person_id": "<string>",
"name": "<string>",
"title": "<string>",
"company_name": "<string>",
"location": "<string>",
"country": "<string>",
"profile_url": "<string>",
"source_updated_at": "<string>",
"employers": [
{
"company_id": "<string>",
"name": "<string>",
"domain": "<string>",
"profile_url": "<string>",
"title": "<string>",
"is_current": true,
"match_basis": "provider_company_id",
"match": "company_id"
}
],
"company_id": "<string>"
}
]
},
"meta": {
"retrieved_at": "2023-11-07T05:31:56Z",
"billing_status": "credits_settled",
"profiles_used": 0,
"request_id": "<string>",
"contract_version": "2026-10-19",
"credit_version": "datalayer_credits_v1",
"upstream_requests": 4,
"lookup_requests": 4,
"credits_used": 1,
"receipt": {
"version": "datalayer_credits_v1",
"request_id": "<string>",
"reserved": 50,
"settled": 50,
"released": 50,
"items": [
{
"kind": "company",
"reference": "<string>",
"credits": 0,
"repeat": true
}
]
},
"replayed": true
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}People
Find people
Native name/query/employer/title/country/skill predicates; seniority/function are bounded-page current-role evaluation. Results retain employer IDs/domains when available.
find people
curl --request POST \
--url https://api.datalayer.so/v1/people/find \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"name": "<string>",
"company": "<string>",
"company_id": "<string>",
"title": "<string>",
"country": "<string>",
"skill": "<string>",
"seniority": "<string>",
"function": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/people/find"
payload = {
"query": "<string>",
"name": "<string>",
"company": "<string>",
"company_id": "<string>",
"title": "<string>",
"country": "<string>",
"skill": "<string>",
"seniority": "<string>",
"function": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
name: '<string>',
company: '<string>',
company_id: '<string>',
title: '<string>',
country: '<string>',
skill: '<string>',
seniority: '<string>',
function: '<string>',
limit: 10,
offset: 0,
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/people/find', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"offset": 4503599627370495,
"limit": 13,
"next_offset": -4503599627369996,
"result_scope": {
"mode": "bounded_shortlist",
"evaluated": 12,
"exhaustive": false,
"scope": "bounded_shortlist",
"filters_applied_to": "<string>",
"provider_total": 4503599627370495,
"indexed_total": 4503599627370495
},
"coverage_note": "<string>",
"total": {
"value": 4503599627370495,
"relation": "eq"
},
"results": [
{
"person_id": "<string>",
"name": "<string>",
"title": "<string>",
"company_name": "<string>",
"location": "<string>",
"country": "<string>",
"profile_url": "<string>",
"source_updated_at": "<string>",
"employers": [
{
"company_id": "<string>",
"name": "<string>",
"domain": "<string>",
"profile_url": "<string>",
"title": "<string>",
"is_current": true,
"match_basis": "provider_company_id",
"match": "company_id"
}
],
"company_id": "<string>"
}
]
},
"meta": {
"retrieved_at": "2023-11-07T05:31:56Z",
"billing_status": "credits_settled",
"profiles_used": 0,
"request_id": "<string>",
"contract_version": "2026-10-19",
"credit_version": "datalayer_credits_v1",
"upstream_requests": 4,
"lookup_requests": 4,
"credits_used": 1,
"receipt": {
"version": "datalayer_credits_v1",
"request_id": "<string>",
"reserved": 50,
"settled": 50,
"released": 50,
"items": [
{
"kind": "company",
"reference": "<string>",
"credits": 0,
"repeat": true
}
]
},
"replayed": true
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}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
Headers
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 - 128Pattern:
^[A-Za-z0-9_-]{1,128}$Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4