Search Person Prospects
curl --request POST \
--url https://api.example.com/api/v1/entities/prospects/person \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"page": 123,
"size": 123,
"contact": {
"contact.fullName": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.socialMediaLink": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.company": {
"current": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"previous": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
}
},
"contact.seniority": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.location": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.departmentAndFunction": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.skill": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.certification": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.keyword": {
"all": {
"include": {
"sources": [
{}
],
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.socialMedia": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.language": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {},
"range": {}
},
"contact.education": {
"school": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {}
},
"degree": {},
"fieldOfStudy": {},
"date": {}
},
"contact.profileBadge": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.experience": {
"current": {
"title": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"duration": {
"currentCompany": {
"min": {
"year": 123,
"month": 123
},
"max": {
"year": 123,
"month": 123
}
},
"currentJob": {},
"total": {}
}
},
"previous": {
"title": {}
}
}
},
"account": {
"account.nameOrDomain": {},
"account.domain": {},
"account.socialMediaLink": {},
"account.phoneNumber": {},
"account.industry": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.location": {},
"account.productAndServices": {},
"account.socialMedia": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.type": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.foundedYear": {},
"account.employeeSize": {
"type": "<string>",
"range": [
{}
]
},
"account.revenue": {},
"account.language": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"range": {}
},
"account.geoLocation": {
"position": {},
"radius": 123,
"unit": "<string>"
},
"account.keyword": {
"all": {
"include": {
"sources": [
{}
],
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"account.funding": {
"type": [
{}
],
"totalAmount": {},
"lastAmount": {},
"duration": {}
},
"account.metric": {
"employee": [
{}
],
"growth": [
{}
]
}
}
}
'import requests
url = "https://api.example.com/api/v1/entities/prospects/person"
payload = {
"page": 123,
"size": 123,
"contact": {
"contact.fullName": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.socialMediaLink": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.company": {
"current": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"previous": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
}
},
"contact.seniority": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.location": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.departmentAndFunction": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.skill": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.certification": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.keyword": {
"all": {
"include": {
"sources": [{}],
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.socialMedia": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.language": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {},
"range": {}
},
"contact.education": {
"school": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {}
},
"degree": {},
"fieldOfStudy": {},
"date": {}
},
"contact.profileBadge": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.experience": {
"current": {
"title": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"duration": {
"currentCompany": {
"min": {
"year": 123,
"month": 123
},
"max": {
"year": 123,
"month": 123
}
},
"currentJob": {},
"total": {}
}
},
"previous": { "title": {} }
}
},
"account": {
"account.nameOrDomain": {},
"account.domain": {},
"account.socialMediaLink": {},
"account.phoneNumber": {},
"account.industry": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.location": {},
"account.productAndServices": {},
"account.socialMedia": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.type": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.foundedYear": {},
"account.employeeSize": {
"type": "<string>",
"range": [{}]
},
"account.revenue": {},
"account.language": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"range": {}
},
"account.geoLocation": {
"position": {},
"radius": 123,
"unit": "<string>"
},
"account.keyword": {
"all": {
"include": {
"sources": [{}],
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"account.funding": {
"type": [{}],
"totalAmount": {},
"lastAmount": {},
"duration": {}
},
"account.metric": {
"employee": [{}],
"growth": [{}]
}
}
}
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({
page: 123,
size: 123,
contact: {
'contact.fullName': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.socialMediaLink': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.company': {
current: {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
previous: {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
}
},
'contact.seniority': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.location': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.departmentAndFunction': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.skill': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.certification': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.keyword': {all: {include: {sources: [{}], content: ['<string>']}, exclude: {}}, any: {}},
'contact.socialMedia': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.language': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {},
range: {}
},
'contact.education': {
school: {all: {include: ['<string>'], exclude: ['<string>']}, any: {}},
degree: {},
fieldOfStudy: {},
date: {}
},
'contact.profileBadge': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.experience': {
current: {
title: {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
duration: {
currentCompany: {min: {year: 123, month: 123}, max: {year: 123, month: 123}},
currentJob: {},
total: {}
}
},
previous: {title: {}}
}
},
account: {
'account.nameOrDomain': {},
'account.domain': {},
'account.socialMediaLink': {},
'account.phoneNumber': {},
'account.industry': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.location': {},
'account.productAndServices': {},
'account.socialMedia': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.type': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.foundedYear': {},
'account.employeeSize': {type: '<string>', range: [{}]},
'account.revenue': {},
'account.language': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']},
range: {}
},
'account.geoLocation': {position: {}, radius: 123, unit: '<string>'},
'account.keyword': {all: {include: {sources: [{}], content: ['<string>']}, exclude: {}}, any: {}},
'account.funding': {type: [{}], totalAmount: {}, lastAmount: {}, duration: {}},
'account.metric': {employee: [{}], growth: [{}]}
}
})
};
fetch('https://api.example.com/api/v1/entities/prospects/person', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/entities/prospects/person",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'page' => 123,
'size' => 123,
'contact' => [
'contact.fullName' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.socialMediaLink' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.company' => [
'current' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'previous' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
]
],
'contact.seniority' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.location' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.departmentAndFunction' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.skill' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.certification' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.keyword' => [
'all' => [
'include' => [
'sources' => [
[
]
],
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.socialMedia' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.language' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
],
'range' => [
]
],
'contact.education' => [
'school' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
]
],
'degree' => [
],
'fieldOfStudy' => [
],
'date' => [
]
],
'contact.profileBadge' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.experience' => [
'current' => [
'title' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'duration' => [
'currentCompany' => [
'min' => [
'year' => 123,
'month' => 123
],
'max' => [
'year' => 123,
'month' => 123
]
],
'currentJob' => [
],
'total' => [
]
]
],
'previous' => [
'title' => [
]
]
]
],
'account' => [
'account.nameOrDomain' => [
],
'account.domain' => [
],
'account.socialMediaLink' => [
],
'account.phoneNumber' => [
],
'account.industry' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.location' => [
],
'account.productAndServices' => [
],
'account.socialMedia' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.type' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.foundedYear' => [
],
'account.employeeSize' => [
'type' => '<string>',
'range' => [
[
]
]
],
'account.revenue' => [
],
'account.language' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'range' => [
]
],
'account.geoLocation' => [
'position' => [
],
'radius' => 123,
'unit' => '<string>'
],
'account.keyword' => [
'all' => [
'include' => [
'sources' => [
[
]
],
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'account.funding' => [
'type' => [
[
]
],
'totalAmount' => [
],
'lastAmount' => [
],
'duration' => [
]
],
'account.metric' => [
'employee' => [
[
]
],
'growth' => [
[
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/entities/prospects/person"
payload := strings.NewReader("{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/entities/prospects/person")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/person")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"totalElements": 1250,
"totalPages": 125,
"number": 0,
"size": 10,
"first": true,
"last": false,
"numberOfElements": 10,
"empty": false,
"content": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"firstName": "Sarah",
"lastName": "Johnson",
"jobTitle": "Chief Technology Officer",
"city": "Austin",
"postalCode": null,
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/sarahjohnson",
"phones": [],
"emails": [],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"seniority": "c_suite",
"industry": "Software",
"departments": ["Engineering", "Technology"],
"subDepartments": [],
"functions": ["technology_operations", "engineering_technical"],
"skills": ["Cloud Architecture", "Team Leadership", "Python", "AWS"],
"languages": [{ "language": "English", "level": "Native" }],
"educations": [
{
"institution": {
"id": null,
"name": "MIT",
"logoUrl": null,
"linkedinUrl": "https://www.linkedin.com/school/mit"
},
"degreeName": "MS",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": { "start": "2008", "end": "2010" }
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "TechStartup Inc",
"logoUrl": "https://logo.example.com/techstartup.png",
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"employees": { "start": "100", "end": "250" }
},
"dates": { "start": "2021-03", "end": null },
"profilePositions": [
{
"company": "TechStartup Inc",
"description": "Leading technology strategy and engineering teams",
"title": "Chief Technology Officer",
"employmentType": "Full-time",
"location": "Austin, TX",
"dates": { "start": "2021-03", "end": null }
}
]
}
],
"certificates": [],
"linkedinProfile": {
"headline": "CTO at TechStartup Inc | Building Scalable Solutions",
"summary": "Technology leader with 15+ years of experience...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_abc123",
"bullhornId": null,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"deletedAt": null,
"birthDate": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"name": "TechStartup Inc",
"description": "Innovative software company focused on enterprise solutions",
"summary": "Enterprise SaaS provider",
"headcount": "100-250",
"industry": "Software",
"phones": [],
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"websiteUrl": "https://www.techstartup.com",
"domain": "techstartup.com",
"city": "Austin",
"postalCode": "78701",
"country": "United States",
"logoUrl": "https://logo.example.com/techstartup.png",
"legalName": "TechStartup Inc.",
"foundedYear": 2018,
"revenue": "$10M-$50M",
"baseProviderId": "baseProvider_company_xyz789",
"bullhornId": null,
"crmId": null,
"location": null
}
}
]
}
{
"totalElements": 0,
"totalPages": 0,
"number": 0,
"size": 10,
"first": true,
"last": true,
"numberOfElements": 0,
"empty": true,
"content": []
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"path": ["size"],
"message": "Number must be less than or equal to 100"
}
]
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Prospects
Search Person Prospects
Search for person prospects using comprehensive account and contact filters, then persist results to the database
POST
/
api
/
v1
/
entities
/
prospects
/
person
Search Person Prospects
curl --request POST \
--url https://api.example.com/api/v1/entities/prospects/person \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"page": 123,
"size": 123,
"contact": {
"contact.fullName": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.socialMediaLink": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.company": {
"current": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"previous": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
}
},
"contact.seniority": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.location": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.departmentAndFunction": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.skill": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.certification": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.keyword": {
"all": {
"include": {
"sources": [
{}
],
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"contact.socialMedia": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.language": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {},
"range": {}
},
"contact.education": {
"school": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {}
},
"degree": {},
"fieldOfStudy": {},
"date": {}
},
"contact.profileBadge": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"contact.experience": {
"current": {
"title": {
"all": {
"include": {
"mode": "<string>",
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"duration": {
"currentCompany": {
"min": {
"year": 123,
"month": 123
},
"max": {
"year": 123,
"month": 123
}
},
"currentJob": {},
"total": {}
}
},
"previous": {
"title": {}
}
}
},
"account": {
"account.nameOrDomain": {},
"account.domain": {},
"account.socialMediaLink": {},
"account.phoneNumber": {},
"account.industry": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.location": {},
"account.productAndServices": {},
"account.socialMedia": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.type": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"account.foundedYear": {},
"account.employeeSize": {
"type": "<string>",
"range": [
{}
]
},
"account.revenue": {},
"account.language": {
"all": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"any": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"range": {}
},
"account.geoLocation": {
"position": {},
"radius": 123,
"unit": "<string>"
},
"account.keyword": {
"all": {
"include": {
"sources": [
{}
],
"content": [
"<string>"
]
},
"exclude": {}
},
"any": {}
},
"account.funding": {
"type": [
{}
],
"totalAmount": {},
"lastAmount": {},
"duration": {}
},
"account.metric": {
"employee": [
{}
],
"growth": [
{}
]
}
}
}
'import requests
url = "https://api.example.com/api/v1/entities/prospects/person"
payload = {
"page": 123,
"size": 123,
"contact": {
"contact.fullName": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.socialMediaLink": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.company": {
"current": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"previous": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
}
},
"contact.seniority": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.location": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.departmentAndFunction": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.skill": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.certification": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.keyword": {
"all": {
"include": {
"sources": [{}],
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"contact.socialMedia": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.language": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {},
"range": {}
},
"contact.education": {
"school": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {}
},
"degree": {},
"fieldOfStudy": {},
"date": {}
},
"contact.profileBadge": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"contact.experience": {
"current": {
"title": {
"all": {
"include": {
"mode": "<string>",
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"duration": {
"currentCompany": {
"min": {
"year": 123,
"month": 123
},
"max": {
"year": 123,
"month": 123
}
},
"currentJob": {},
"total": {}
}
},
"previous": { "title": {} }
}
},
"account": {
"account.nameOrDomain": {},
"account.domain": {},
"account.socialMediaLink": {},
"account.phoneNumber": {},
"account.industry": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.location": {},
"account.productAndServices": {},
"account.socialMedia": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.type": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"account.foundedYear": {},
"account.employeeSize": {
"type": "<string>",
"range": [{}]
},
"account.revenue": {},
"account.language": {
"all": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"any": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"range": {}
},
"account.geoLocation": {
"position": {},
"radius": 123,
"unit": "<string>"
},
"account.keyword": {
"all": {
"include": {
"sources": [{}],
"content": ["<string>"]
},
"exclude": {}
},
"any": {}
},
"account.funding": {
"type": [{}],
"totalAmount": {},
"lastAmount": {},
"duration": {}
},
"account.metric": {
"employee": [{}],
"growth": [{}]
}
}
}
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({
page: 123,
size: 123,
contact: {
'contact.fullName': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.socialMediaLink': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.company': {
current: {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
previous: {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
}
},
'contact.seniority': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.location': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.departmentAndFunction': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.skill': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.certification': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
'contact.keyword': {all: {include: {sources: [{}], content: ['<string>']}, exclude: {}}, any: {}},
'contact.socialMedia': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.language': {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {},
range: {}
},
'contact.education': {
school: {all: {include: ['<string>'], exclude: ['<string>']}, any: {}},
degree: {},
fieldOfStudy: {},
date: {}
},
'contact.profileBadge': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'contact.experience': {
current: {
title: {
all: {include: {mode: '<string>', content: ['<string>']}, exclude: {}},
any: {}
},
duration: {
currentCompany: {min: {year: 123, month: 123}, max: {year: 123, month: 123}},
currentJob: {},
total: {}
}
},
previous: {title: {}}
}
},
account: {
'account.nameOrDomain': {},
'account.domain': {},
'account.socialMediaLink': {},
'account.phoneNumber': {},
'account.industry': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.location': {},
'account.productAndServices': {},
'account.socialMedia': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.type': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']}
},
'account.foundedYear': {},
'account.employeeSize': {type: '<string>', range: [{}]},
'account.revenue': {},
'account.language': {
all: {include: ['<string>'], exclude: ['<string>']},
any: {include: ['<string>'], exclude: ['<string>']},
range: {}
},
'account.geoLocation': {position: {}, radius: 123, unit: '<string>'},
'account.keyword': {all: {include: {sources: [{}], content: ['<string>']}, exclude: {}}, any: {}},
'account.funding': {type: [{}], totalAmount: {}, lastAmount: {}, duration: {}},
'account.metric': {employee: [{}], growth: [{}]}
}
})
};
fetch('https://api.example.com/api/v1/entities/prospects/person', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/entities/prospects/person",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'page' => 123,
'size' => 123,
'contact' => [
'contact.fullName' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.socialMediaLink' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.company' => [
'current' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'previous' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
]
],
'contact.seniority' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.location' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.departmentAndFunction' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.skill' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.certification' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.keyword' => [
'all' => [
'include' => [
'sources' => [
[
]
],
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'contact.socialMedia' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.language' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
],
'range' => [
]
],
'contact.education' => [
'school' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
]
],
'degree' => [
],
'fieldOfStudy' => [
],
'date' => [
]
],
'contact.profileBadge' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'contact.experience' => [
'current' => [
'title' => [
'all' => [
'include' => [
'mode' => '<string>',
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'duration' => [
'currentCompany' => [
'min' => [
'year' => 123,
'month' => 123
],
'max' => [
'year' => 123,
'month' => 123
]
],
'currentJob' => [
],
'total' => [
]
]
],
'previous' => [
'title' => [
]
]
]
],
'account' => [
'account.nameOrDomain' => [
],
'account.domain' => [
],
'account.socialMediaLink' => [
],
'account.phoneNumber' => [
],
'account.industry' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.location' => [
],
'account.productAndServices' => [
],
'account.socialMedia' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.type' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'account.foundedYear' => [
],
'account.employeeSize' => [
'type' => '<string>',
'range' => [
[
]
]
],
'account.revenue' => [
],
'account.language' => [
'all' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'any' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'range' => [
]
],
'account.geoLocation' => [
'position' => [
],
'radius' => 123,
'unit' => '<string>'
],
'account.keyword' => [
'all' => [
'include' => [
'sources' => [
[
]
],
'content' => [
'<string>'
]
],
'exclude' => [
]
],
'any' => [
]
],
'account.funding' => [
'type' => [
[
]
],
'totalAmount' => [
],
'lastAmount' => [
],
'duration' => [
]
],
'account.metric' => [
'employee' => [
[
]
],
'growth' => [
[
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/entities/prospects/person"
payload := strings.NewReader("{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/entities/prospects/person")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/person")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"page\": 123,\n \"size\": 123,\n \"contact\": {\n \"contact.fullName\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMediaLink\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.company\": {\n \"current\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"previous\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n }\n },\n \"contact.seniority\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.location\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.departmentAndFunction\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.skill\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.certification\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"contact.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.language\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {},\n \"range\": {}\n },\n \"contact.education\": {\n \"school\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {}\n },\n \"degree\": {},\n \"fieldOfStudy\": {},\n \"date\": {}\n },\n \"contact.profileBadge\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"contact.experience\": {\n \"current\": {\n \"title\": {\n \"all\": {\n \"include\": {\n \"mode\": \"<string>\",\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"duration\": {\n \"currentCompany\": {\n \"min\": {\n \"year\": 123,\n \"month\": 123\n },\n \"max\": {\n \"year\": 123,\n \"month\": 123\n }\n },\n \"currentJob\": {},\n \"total\": {}\n }\n },\n \"previous\": {\n \"title\": {}\n }\n }\n },\n \"account\": {\n \"account.nameOrDomain\": {},\n \"account.domain\": {},\n \"account.socialMediaLink\": {},\n \"account.phoneNumber\": {},\n \"account.industry\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.location\": {},\n \"account.productAndServices\": {},\n \"account.socialMedia\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.type\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"account.foundedYear\": {},\n \"account.employeeSize\": {\n \"type\": \"<string>\",\n \"range\": [\n {}\n ]\n },\n \"account.revenue\": {},\n \"account.language\": {\n \"all\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"any\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"range\": {}\n },\n \"account.geoLocation\": {\n \"position\": {},\n \"radius\": 123,\n \"unit\": \"<string>\"\n },\n \"account.keyword\": {\n \"all\": {\n \"include\": {\n \"sources\": [\n {}\n ],\n \"content\": [\n \"<string>\"\n ]\n },\n \"exclude\": {}\n },\n \"any\": {}\n },\n \"account.funding\": {\n \"type\": [\n {}\n ],\n \"totalAmount\": {},\n \"lastAmount\": {},\n \"duration\": {}\n },\n \"account.metric\": {\n \"employee\": [\n {}\n ],\n \"growth\": [\n {}\n ]\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"totalElements": 1250,
"totalPages": 125,
"number": 0,
"size": 10,
"first": true,
"last": false,
"numberOfElements": 10,
"empty": false,
"content": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"firstName": "Sarah",
"lastName": "Johnson",
"jobTitle": "Chief Technology Officer",
"city": "Austin",
"postalCode": null,
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/sarahjohnson",
"phones": [],
"emails": [],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"seniority": "c_suite",
"industry": "Software",
"departments": ["Engineering", "Technology"],
"subDepartments": [],
"functions": ["technology_operations", "engineering_technical"],
"skills": ["Cloud Architecture", "Team Leadership", "Python", "AWS"],
"languages": [{ "language": "English", "level": "Native" }],
"educations": [
{
"institution": {
"id": null,
"name": "MIT",
"logoUrl": null,
"linkedinUrl": "https://www.linkedin.com/school/mit"
},
"degreeName": "MS",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": { "start": "2008", "end": "2010" }
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "TechStartup Inc",
"logoUrl": "https://logo.example.com/techstartup.png",
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"employees": { "start": "100", "end": "250" }
},
"dates": { "start": "2021-03", "end": null },
"profilePositions": [
{
"company": "TechStartup Inc",
"description": "Leading technology strategy and engineering teams",
"title": "Chief Technology Officer",
"employmentType": "Full-time",
"location": "Austin, TX",
"dates": { "start": "2021-03", "end": null }
}
]
}
],
"certificates": [],
"linkedinProfile": {
"headline": "CTO at TechStartup Inc | Building Scalable Solutions",
"summary": "Technology leader with 15+ years of experience...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_abc123",
"bullhornId": null,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"deletedAt": null,
"birthDate": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"name": "TechStartup Inc",
"description": "Innovative software company focused on enterprise solutions",
"summary": "Enterprise SaaS provider",
"headcount": "100-250",
"industry": "Software",
"phones": [],
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"websiteUrl": "https://www.techstartup.com",
"domain": "techstartup.com",
"city": "Austin",
"postalCode": "78701",
"country": "United States",
"logoUrl": "https://logo.example.com/techstartup.png",
"legalName": "TechStartup Inc.",
"foundedYear": 2018,
"revenue": "$10M-$50M",
"baseProviderId": "baseProvider_company_xyz789",
"bullhornId": null,
"crmId": null,
"location": null
}
}
]
}
{
"totalElements": 0,
"totalPages": 0,
"number": 0,
"size": 10,
"first": true,
"last": true,
"numberOfElements": 0,
"empty": true,
"content": []
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"path": ["size"],
"message": "Number must be less than or equal to 100"
}
]
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Searches for person prospects using data providers with extensive filtering capabilities. Results are automatically mapped to domain objects and persisted to the global database (companies and persons are upserted), returning enriched lead objects with associated company data.
Authentication
This endpoint requires authentication. The user must be signed in to access prospect search functionality.This endpoint performs a search against the Lance database of 400+ million
professional profiles. Results are automatically saved to Lance’s database,
deduplicating and merging with existing records.
Request
The request body allows filtering by both account (company) criteria and contact (person) criteria. All filters are optional and can be combined.Pagination
integer
default:"0"
Page number for pagination (0-indexed)
integer
default:"10"
Number of results per page. Must be between 0 and 100.
Contact Filters
object
Filters for the individual/person being searched
Show Contact filter properties
Show Contact filter properties
object
object
object
Filter by current and/or previous companies
Show Company filter structure
Show Company filter structure
object
object
Filter by seniority level. Values:
senior, manager, entry, mid-level, director, c_suite, intern, founder, owner, head, vp, partnerobject
object
Filter by department and job function. Extensive list including:Executive:
c_suite, executive, founderProduct: product_management, product_development, product_mangementEngineering: master_engineering_technical, artificial_intelligence_machine_learning, bioengineering, biometrics, business_intelligence, chemical_engineering, cloud_mobility, data_science, devops, emerging_technology_innovation, engineering_technical, industrial_engineering, mechanic, mobile_development, project_management, research_development, scrum_master_agile_coach, software_development, support_technical_services, technician, technology_operations, test_quality_assurance, ui_ux, web_developmentDesign: marketing, digital_marketing, design, all_design, product_ui_ux_design, graphic_designEducation: education, teacher, principal, superintendent, professorFinance: master_finance, accounting, finance, financial_planning_analysis, financial_reporting, financial_strategy, financial_systems, internal_audit_control, investor_relations, mergers_acquisitions, financial_risk, sourcing_procurement, tax, treasuryHR: master_human_resources, compensation_benefits, culture_diversity_inclusion, employee_labor_relations, health_safety, human_resource_information_system, human_resources, hr_business_partner, learning_development, organizational_development, recruiting_talent_acquisition, talent_management, workforce_mangementIT: master_information_technology, application_development, business_service_management_itsm, collaboration_web_app, data_center, data_warehouse, database_administration, ecommerce_development, enterprise_architecture, help_desk_desktop_services, hr_financial_erp_systems, information_security, information_technology, infrastructure, it_asset_management, it_audit_it_compliance, it_operations, it_procurement, it_strategy, networking, project_program_management, quality_assurance, retail_store_systems, servers, storage_disaster_recovery, telecommunications, virtualizationLegal: master_legal, compliance, contracts, ediscovery, governmental_affairs_regulatory_law, intellectual_property_patent, labor_employment, lawyer_attorney, legal, legal_counsel, legal_operations, litigation, privacyMarketing: master_marketing, advertising, brand_management, content_marketing, customer_experience, customer_marketing, demand_generation, ecommerce_marketing, event_marketing, field_marketing, lead_generation, marketing_analytics_insights, marketing_communications, product_marketing, public_relations, search_engine_optimization_pay_per_click, social_media_marketing, strategic_communications, technical_marketingSales: sales, field_outside_sales, master_sales, account_management, business_development, channel_sales, customer_retention_development, inside_sales, partnerships, sales_enablement, sales_engineering, sales_operations, sales_trainingMedical: medical_health, chiropractics, dentistry, doctors_physicians, first_responder, infectious_disease, medical_administration, medical_education_training, medicine, neurology, nursing, nutrition_dietetics, oncology, pathology, pharmacy, physical_therapy, psychology, public_health, radiology, social_workOperations: master_operations, call_center, construction, corporate_strategy, customer_service_support, enterprise_resource_planning, facilities_management, leasing, logistics, office_operations, operations, physical_security, project_development, quality_management, real_estate, store_operations, supply_chain, customer_successConsulting: consulting, consultantobject
object
object
Filter by keywords across multiple profile sources.Sources:
ORGANIZATION, TEST_SCORE, AWARD, WORK_HISTORY_DESCRIPTION, PUBLICATION, SUMMARY, PATENT, VOLUNTEERING, HEADLINE, EDUCATION_DESCRIPTION, COURSE, PROJECTS, SKILL, LANGUAGE_SKILL, CERTIFICATIONobject
Filter by social media presence. Values:
FACEBOOK, INSTAGRAM, TWITTER, LINKEDINobject
Filter by language skills with proficiency range. Supports 49 languages:
english, spanish, french, portuguese, german, dutch, italian, chinese, turkish, polish, russian, swedish, arabic, indonesian, danish, czech, norwegian, japanese, korean, romanian, ukrainian, thai, hindi, malay, tagalog, vietnamese, finnish, persian, greek, hungarian, bengali, marathi, telugu, panjabi, serbian, slovak, croatian, lithuanian, latvian, albanian, icelandic, armenian, bosnian, tamil, javanese, malayalam, kannada, burmeseShow language properties
Show language properties
object
Filter by education background
Show Education filter structure
Show Education filter structure
object
object
Filter by degree types with search mode (
SMART, WORD, STRICT)object
Filter by fields of study with search mode
object
object
Filter by work experience
Show Experience filter structure
Show Experience filter structure
object
Current role filters
Show current properties
Show current properties
object
Account Filters
object
Filters for the company/account associated with the person
Show Account filter properties
Show Account filter properties
object
Filter by company name or domain with search modes (
SMART, WORD, STRICT)object
Filter by company domain (include/exclude arrays)
object
Filter by company social media profile URLs (include/exclude arrays)
object
Filter by company phone numbers (include/exclude arrays)
object
Filter by industry. Supports 900+ industries including:
software development, it services and it consulting, financial services, hospitals and health care, manufacturing, retail, construction, real estate, education, marketing, biotechnology, telecommunications, saas, fintech, artificial intelligence (ai), generative ai, and many more.object
Filter by company location (include/exclude arrays)
object
Filter by company products and services with search modes (
SMART, WORD, STRICT)object
Filter by company social media presence. Values:
FACEBOOK, INSTAGRAM, TWITTER, LINKEDINobject
Filter by company type. Values:
PRIVATELY_HELD, PUBLIC_COMPANY, GOVERNMENT_AGENCY, PARTNERSHIP, SOLE_PROPRIETORSHIP, NON_PROFIT, EDUCATIONAL, SELF_OWNED, SELF_EMPLOYEDobject
Filter by company founded year range
{start, end}object
object
Filter by company revenue range (same structure as employeeSize)
object
Filter by company operating language. Supports 49 languages:
english, spanish, french, portuguese, german, dutch, italian, chinese, turkish, polish, russian, swedish, arabic, indonesian, danish, czech, norwegian, japanese, korean, romanian, ukrainian, thai, hindi, malay, tagalog, vietnamese, finnish, persian, greek, hungarian, bengali, marathi, telugu, panjabi, serbian, slovak, croatian, lithuanian, latvian, albanian, icelandic, armenian, bosnian, tamil, javanese, malayalam, kannada, burmese.Show language properties
Show language properties
object
object
Search by keywords across company data sources.
object
Filter by funding details
Show Funding filter structure
Show Funding filter structure
array
Funding types:
PRE_SEED, SEED, SERIES_A through SERIES_J, VENTURE_ROUND, ANGEL, PRIVATE_EQUITY, DEBT_FINANCING, CONVERTIBLE_NOTE, GRANT, CORPORATE_ROUND, EQUITY_CROWDFUNDING, PRODUCT_CROWDFUNDING, SECONDARY_MARKET, POST_IPO_EQUITY, POST_IPO_DEBT, POST_IPO_SECONDARY, NON_EQUITY_ASSISTANCE, INITIAL_COIN_OFFERING, UNDISCLOSED, SERIES_UNKNOWN, FUNDING_ROUNDobject
Total funding amount range
{start, end}object
Last funding round amount range
{start, end}object
Funding date range
{start, end} as ISO timestampsobject
Filter by company metrics
Show Metrics filter structure
Show Metrics filter structure
object[]
Array of employee count filters by department. Each object has:
function: array of department enums (program_and_project_management,education,purchasing,accounting,sales,research,operations,customer_success_and_support,legal,product_management,media_and_communication,real_estate,quality_assurance,consulting,arts_and_design,healthcare_services,entrepreneurship,engineering,community_and_social_services,marketing,information_technology,business_development,administrative,military_and_protective_services,finance,human_resources,support)start: minimum employee countend: maximum employee count
object[]
Array of headcount growth filters by department. Each object has:
function: array of department enums (same as employee, also accepts custom strings)start: minimum growth percentageend: maximum growth percentagetimeFrame:ONE,THREE,SIX,TWELVE, orTWENTY_FOUR(months)
Response
Returns a paginated response containing leads (persons with associated company data).Lead[]
Array of lead objects matching the search criteria
Show Lead object properties
Show Lead object properties
string
required
Unique identifier (UUID) for the person
string
ISO 8601 timestamp when the person was created. Can be null.
string
ISO 8601 timestamp when the person was last updated. Can be null.
string
required
Person’s first name
string
required
Person’s last name
string
Person’s current job title. Can be null.
string
Person’s city. Can be null.
string
Person’s postal/zip code. Can be null.
string
Person’s country. Can be null.
string
Person’s LinkedIn profile URL. Can be null.
string[]
Array of phone numbers. Defaults to empty array.
string[]
Array of email addresses (lowercased). Defaults to empty array.
string
UUID of the associated company. Can be null.
string
Person’s seniority level. Can be null.
string
Person’s industry. Can be null.
string[]
Array of department names. Defaults to empty array.
string[]
Array of sub-department names. Defaults to empty array.
string[]
Array of job functions. Defaults to empty array.
string[]
Array of skills. Defaults to empty array.
Language[]
Array of language proficiencies with
language and level fields.Education[]
Array of educational background with institution, degree, field of study, and dates.
WorkExperience[]
Array of work history with company details and profile positions.
Certificate[]
Array of certifications with name, authority, and dates.
object
LinkedIn profile data with headline, summary, and pictureUrl.
string
Internal data provider identifier. Can be null.
string
Generic CRM identifier. Can be null.
string
ID of the user who owns this lead. Can be null.
Company
Associated company data. Can be null.
Show Company object properties
Show Company object properties
string
required
Unique identifier (UUID)
string
ISO 8601 timestamp when the company was created. Can be null.
string
ISO 8601 timestamp when the company was last updated. Can be null.
string
required
Company name
string
Company description. Can be null.
string
Brief company summary. Can be null.
string
Employee count range. Can be null.
string
Industry classification. Can be null.
string[]
Company phone numbers.
string
Company LinkedIn URL. Can be null.
string
Company website URL. Can be null.
string
Company domain. Can be null.
string
Headquarters city. Can be null.
string
Headquarters postal code. Can be null.
string
Headquarters country. Can be null.
string
Company logo URL. Can be null.
string
Legal/registered company name. Can be null.
number
Year founded. Can be null.
string
Revenue range. Can be null.
object
Detailed location information. Can be null.
string
Lance internal provider ID. Can be null.
string
Generic CRM identifier. Can be null.
integer
Total number of matching results across all pages. Can be null.
integer
Total number of pages available. Can be null.
integer
Current page number (0-indexed). Can be null.
integer
Number of results per page. Can be null.
boolean
Whether this is the first page. Can be null.
boolean
Whether this is the last page. Can be null.
integer
Number of elements on the current page. Can be null.
boolean
Whether the result set is empty. Can be null.
Response Examples
{
"totalElements": 1250,
"totalPages": 125,
"number": 0,
"size": 10,
"first": true,
"last": false,
"numberOfElements": 10,
"empty": false,
"content": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"firstName": "Sarah",
"lastName": "Johnson",
"jobTitle": "Chief Technology Officer",
"city": "Austin",
"postalCode": null,
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/sarahjohnson",
"phones": [],
"emails": [],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"seniority": "c_suite",
"industry": "Software",
"departments": ["Engineering", "Technology"],
"subDepartments": [],
"functions": ["technology_operations", "engineering_technical"],
"skills": ["Cloud Architecture", "Team Leadership", "Python", "AWS"],
"languages": [{ "language": "English", "level": "Native" }],
"educations": [
{
"institution": {
"id": null,
"name": "MIT",
"logoUrl": null,
"linkedinUrl": "https://www.linkedin.com/school/mit"
},
"degreeName": "MS",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": { "start": "2008", "end": "2010" }
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "TechStartup Inc",
"logoUrl": "https://logo.example.com/techstartup.png",
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"employees": { "start": "100", "end": "250" }
},
"dates": { "start": "2021-03", "end": null },
"profilePositions": [
{
"company": "TechStartup Inc",
"description": "Leading technology strategy and engineering teams",
"title": "Chief Technology Officer",
"employmentType": "Full-time",
"location": "Austin, TX",
"dates": { "start": "2021-03", "end": null }
}
]
}
],
"certificates": [],
"linkedinProfile": {
"headline": "CTO at TechStartup Inc | Building Scalable Solutions",
"summary": "Technology leader with 15+ years of experience...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_abc123",
"bullhornId": null,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"deletedAt": null,
"birthDate": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"name": "TechStartup Inc",
"description": "Innovative software company focused on enterprise solutions",
"summary": "Enterprise SaaS provider",
"headcount": "100-250",
"industry": "Software",
"phones": [],
"linkedinUrl": "https://www.linkedin.com/company/techstartup",
"websiteUrl": "https://www.techstartup.com",
"domain": "techstartup.com",
"city": "Austin",
"postalCode": "78701",
"country": "United States",
"logoUrl": "https://logo.example.com/techstartup.png",
"legalName": "TechStartup Inc.",
"foundedYear": 2018,
"revenue": "$10M-$50M",
"baseProviderId": "baseProvider_company_xyz789",
"bullhornId": null,
"crmId": null,
"location": null
}
}
]
}
{
"totalElements": 0,
"totalPages": 0,
"number": 0,
"size": 10,
"first": true,
"last": true,
"numberOfElements": 0,
"empty": true,
"content": []
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"path": ["size"],
"message": "Number must be less than or equal to 100"
}
]
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Request Examples
Basic Search - CTOs in Software Industry
{
"contact": {
"seniority": {
"any": {
"include": ["c_suite"]
}
},
"experience": {
"current": {
"title": {
"any": {
"include": {
"mode": "SMART",
"content": ["CTO", "Chief Technology Officer"]
}
}
}
}
}
},
"account": {
"industry": {
"any": {
"include": ["software development", "software"]
}
}
},
"page": 0,
"size": 25
}
Search by Company Size and Location
{
"contact": {
"departmentAndFunction": {
"any": {
"include": ["sales", "business_development"]
}
},
"location": {
"any": {
"include": ["San Francisco", "New York", "Boston"]
}
}
},
"account": {
"employeeSize": {
"type": "RANGE",
"range": [{ "start": 50, "end": 500 }]
}
},
"page": 0,
"size": 50
}
Search by Skills and Funding Stage
{
"contact": {
"skill": {
"any": {
"include": {
"mode": "SMART",
"content": ["Machine Learning", "AI", "Python"]
}
}
}
},
"account": {
"funding": {
"type": ["SERIES_A", "SERIES_B", "SERIES_C"]
}
},
"page": 0,
"size": 20
}
Search by Keywords Across Profile Sources
{
"contact": {
"keyword": {
"any": {
"include": {
"sources": [
{ "mode": "SMART", "source": "HEADLINE" },
{ "mode": "SMART", "source": "SUMMARY" },
{ "mode": "SMART", "source": "SKILL" }
],
"content": ["data engineering", "ETL", "data pipeline"]
}
}
}
},
"page": 0,
"size": 25
}
Search by Experience Duration
{
"contact": {
"seniority": {
"any": {
"include": ["manager", "director"]
}
},
"experience": {
"current": {
"duration": {
"currentCompany": {
"min": { "year": 2, "month": 0 },
"max": { "year": 5, "month": 0 }
},
"total": {
"min": { "year": 8, "month": 0 }
}
}
}
}
},
"page": 0,
"size": 20
}
Search People Open to Work
{
"contact": {
"profileBadge": {
"any": {
"include": ["OPEN_TO_WORK"]
}
},
"departmentAndFunction": {
"any": {
"include": ["software_development", "data_science"]
}
}
},
"page": 0,
"size": 25
}
How It Works
- Authentication: The endpoint authenticates the user via Clerk
- Validation: Request body is validated against the
PeopleSearch_Bodyschema - Search: Queries the Lance database with the provided filters
- Mapping: Maps external provider response data to Lance domain objects (Person and Company)
- Persistence: Companies and persons are upserted to the global database using merge logic to preserve existing data
- Response: Returns the enriched leads with associated company data
Results are automatically deduplicated during the upsert process. If a person
or company already exists in the database (matched by external IDs or other
identifiers), the records are merged rather than duplicated.
Notes
- Search results are persisted to the database, making subsequent searches faster for the same prospects
- The external provider integration uses rate limiting (5 requests per second) to avoid overwhelming the external service
- Company data is extracted from the person’s current position or position groups if available
- The
companyIdfield in the response links each person to their saved company record - External provider IDs (
baseProviderId) are preserved to enable future enrichment and deduplication