API ReferencePerson

Simple Search

Simplified search endpoint with pre-defined query parameters for easier filtering

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerRequired
perPageintegerRequired
Maximum 100 results per page
enrichbooleanOptional

If true, automatically enrich results (charges 1 person credit per result). Otherwise returns minimal results.

fullNamestringOptional
Fuzzy query on name
firstNamelist of stringsOptional

Exact match (case insensitive). Multiple values are OR’d.

lastNamelist of stringsOptional

Exact match (case insensitive). Multiple values are OR’d.

headlinestringOptional
Keyword search on headline
minLinkedinConnectionsintegerOptional
Minimum number of LinkedIn connections
maxLinkedinConnectionsintegerOptional
Maximum number of LinkedIn connections
minLinkedinFollowersintegerOptional
Minimum number of LinkedIn followers
maxLinkedinFollowersintegerOptional
Maximum number of LinkedIn followers
countrylist of stringsOptional
Filter by country. Multiple values are OR'd.
regionlist of stringsOptional

Filter by region/state. Multiple values are OR’d.

localitylist of stringsOptional

Filter by city/locality. Multiple values are OR’d.

skillslist of stringsOptional

All specified skills must be present (AND condition)

allTitleslist of stringsOptional
Filter by all titles a person has had. Multiple values are OR'd.
currentTitleslist of stringsOptional
Filter by current titles. Multiple values are OR'd.
pastTitleslist of stringsOptional

Filter by past (non-current) titles. Multiple values are OR’d.

allDepartmentslist of stringsOptional
Filter by all departments. Multiple values are OR'd.
currentDepartmentslist of stringsOptional
Filter by current departments. Multiple values are OR'd.
pastDepartmentslist of stringsOptional
Filter by past departments. Multiple values are OR'd.
degreeslist of stringsOptional
Filter by degrees. Multiple values are OR'd.
fieldsOfStudylist of stringsOptional
Filter by fields of study. Multiple values are OR'd.
allSchoolLinkedinIDslist of stringsOptional

Filter by all schools (LinkedIn ID). Multiple values are OR’d.

currentSchoolLinkedinIDslist of stringsOptional

Filter by current schools (LinkedIn ID). Multiple values are OR’d.

pastSchoolLinkedinIDslist of stringsOptional

Filter by past schools (LinkedIn ID). Multiple values are OR’d.

allSchoolLinkedinNumIDslist of stringsOptional

Filter by all schools (LinkedIn Num ID). Multiple values are OR’d.

currentSchoolLinkedinNumIDslist of stringsOptional

Filter by current schools (LinkedIn Num ID). Multiple values are OR’d.

pastSchoolLinkedinNumIDslist of stringsOptional

Filter by past schools (LinkedIn Num ID). Multiple values are OR’d.

allCompanyLinkedinIDslist of stringsOptional

Filter by all companies (LinkedIn ID). Multiple values are OR’d.

currentCompanyLinkedinIDslist of stringsOptional

Filter by current companies (LinkedIn ID). Multiple values are OR’d.

pastCompanyLinkedinIDslist of stringsOptional

Filter by past companies (LinkedIn ID). Multiple values are OR’d.

allCompanyLinkedinNumIDslist of stringsOptional

Filter by all companies (LinkedIn Num ID). Multiple values are OR’d.

currentCompanyLinkedinNumIDslist of stringsOptional

Filter by current companies (LinkedIn Num ID). Multiple values are OR’d.

pastCompanyLinkedinNumIDslist of stringsOptional

Filter by past companies (LinkedIn Num ID). Multiple values are OR’d.

allCompanyNameslist of stringsOptional
Filter by all company names. Multiple values are OR'd.
currentCompanyNameslist of stringsOptional
Filter by current company names. Multiple values are OR'd.
pastCompanyNameslist of stringsOptional
Filter by past company names. Multiple values are OR'd.
allExperienceDescriptionsstringOptional
Keyword search on all experience descriptions
currentExperienceDescriptionsstringOptional
Keyword search on current experience descriptions
pastExperienceDescriptionsstringOptional
Keyword search on past experience descriptions

Response

This endpoint returns an object.
countobject
itemslist of any
pagesinteger
totalResultsinteger

Errors

400
Bad Request Error
401
Unauthorized Error
429
Rate Limit Error