Built-in tool
Search People Database
Search a large people database by title, seniority, employer, location, skills and education.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| current_employment_job_titlesstring · optional | string | optional | Current job titles (comma-separated; prefix a value with - to exclude it) Example: |
| previous_employment_job_titlesstring · optional | string | optional | Previous job titles (comma-separated; prefix with - to exclude) Example: |
| current_employment_seniority_levelsarray · optional | array | optional | Current seniority levels One of: |
| previous_employment_seniority_levelsarray · optional | array | optional | Previous seniority levels One of: |
| current_employment_job_functionsarray · optional | array | optional | Job function of the current role One of: |
| current_employer_namesstring · optional | string | optional | Current employer names (comma-separated; prefix with - to exclude) Example: |
| previous_employer_namesstring · optional | string | optional | Previous employer names (comma-separated; prefix with - to exclude) Example: |
| current_employer_domainsstring · optional | string | optional | Current employer website domains (comma-separated; prefix with - to exclude) Example: |
| previous_employer_domainsstring · optional | string | optional | Previous employer website domains (comma-separated; prefix with - to exclude) Example: |
| current_employer_industriesstring · optional | string | optional | LinkedIn industries of the current employer (comma-separated; prefix with - to exclude) Example: |
| previous_employer_industriesstring · optional | string | optional | LinkedIn industries of previous employers (comma-separated; prefix with - to exclude) Example: |
| current_employer_headcount_bracketsarray · optional | array | optional | Headcount bracket of the current employer One of: |
| current_employment_tenure_bracketsarray · optional | array | optional | Tenure at the current company One of: |
| total_years_of_experience_bracketsarray · optional | array | optional | Total years of experience One of: |
| locationsstring · optional | string | optional | Location filter (comma-separated; prefix with - to exclude) Example: |
| languagesstring · optional | string | optional | Languages spoken (comma-separated; prefix with - to exclude) Example: |
| skillsstring · optional | string | optional | Skills filter (comma-separated; prefix with - to exclude) Example: |
| profile_headline_keywordsstring · optional | string | optional | Profile headline keywords (comma-separated; prefix with - to exclude) Example: |
| about_section_keywordsstring · optional | string | optional | Keywords in the profile About section (comma-separated; prefix with - to exclude) Example: |
| school_namesstring · optional | string | optional | School/university names (comma-separated; prefix with - to exclude) Example: |
| current_school_namesstring · optional | string | optional | Currently attending schools (comma-separated) Example: |
| degree_namesstring · optional | string | optional | Degree types (comma-separated) Example: |
| fields_of_studystring · optional | string | optional | Fields of study (comma-separated) Example: |
| certificationsstring · optional | string | optional | Certifications (comma-separated) Example: |
| honorsstring · optional | string | optional | Honors and awards (comma-separated) Example: |
| recently_changed_jobsstring · optional | string | optional | One of: |
| limitnumber · optional | number | optional | Maximum results to return per call (1-100). Billed per profile returned. Default: Example: |
Response schema
{
"fields": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"job_title": {
"type": "string"
},
"profile_url": {
"type": "string"
},
"company_name": {
"type": "string"
},
"company_website_url": {
"type": "string"
},
"person_profile_match": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"about": {
"type": "string"
},
"skills": {
"type": "array"
},
"headline": {
"type": "string"
},
"languages": {
"type": "array"
},
"profile_url": {
"type": "string"
},
"connections_count": {
"type": "number"
},
"education_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
},
"degree_name": {
"type": "string"
},
"field_of_study": {
"type": "string"
},
"institution_name": {
"type": "string"
}
}
}
},
"primary_job_title": {
"type": "string"
},
"employment_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"end_date": {
"type": "string"
},
"job_title": {
"type": "string"
},
"start_date": {
"type": "string"
},
"company_name": {
"type": "string"
},
"company_domain": {
"type": "string"
},
"seniority_level": {
"type": "string"
},
"tenure_in_years": {
"type": "number"
},
"company_hq_region": {
"type": "string"
},
"headcount_bracket": {
"type": "string"
},
"company_industries": {
"type": "array"
},
"company_profile_url": {
"type": "string"
},
"company_website_url": {
"type": "string"
},
"is_current_employer": {
"type": "boolean"
},
"is_primary_current_employer": {
"type": "boolean"
}
}
}
},
"primary_department": {
"type": "string"
},
"profile_picture_url": {
"type": "string"
},
"current_location_city": {
"type": "string"
},
"current_location_state": {
"type": "string"
},
"primary_company_domain": {
"type": "string"
},
"primary_sub_department": {
"type": "string"
},
"current_location_country": {
"type": "string"
},
"highest_current_seniority_level": {
"type": "string"
}
}
}
}
}
},
"next_page": {
"type": "object"
},
"search_id": {
"type": "string"
},
"total_pages": {
"type": "number"
},
"organization_id": {
"type": "string"
},
"pagination_type": {
"type": "string"
}
},
"preferredFormat": "json"
}