Built-in tool
Search People
Search for people by job title, seniority, department, current company, industry, company size and location, and return one page of matching profiles.
5 creditsNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| jobTitlesarray · optional | array | optional | Current job titles to match. Example: |
| jobTitlesExcludearray · optional | array | optional | Current job titles to leave out. Example: |
| seniorityLevelsarray · optional | array | optional | Seniority of the current role. One of: |
| jobFunctionsarray · optional | array | optional | Department of the current role. One of: |
| companiesListarray · optional | array | optional | Only people currently working at these companies, by company name. Matching is by name, so a common name can also match similarly named companies. Example: |
| industriesarray · optional | array | optional | LinkedIn industry names of the person's current company. Example: |
| companySizesarray · optional | array | optional | Employee-count bucket of the current company. One of: |
| companyKeywordsarray · optional | array | optional | Keywords matched against the current company's profile. Example: |
| countriesarray · optional | array | optional | Countries the person is in, as names or ISO-2 codes. Example: |
| citiesarray · optional | array | optional | Cities or regions the person is in. Example: |
| limitnumber · optional | number | optional | Maximum results to return in this run (1-50). Each result costs 0.1 credits; an empty page costs nothing. Default: |
| cursorstring · optional | string | optional | Resume token from a previous run's meta.cursor, to fetch the next page of the same search. Leave empty to start from the first page. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"status",
"data",
"meta"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"title",
"headline",
"company",
"company_domain",
"company_linkedin_url",
"location",
"linkedin_url",
"summary",
"connections",
"skills",
"education",
"certifications",
"profile_photo_url"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"skills": {
"type": [
"string",
"null"
]
},
"company": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"education": {
"type": [
"string",
"null"
]
},
"connections": {
"type": [
"number",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"certifications": {
"type": [
"string",
"null"
]
},
"company_domain": {
"type": [
"string",
"null"
]
},
"profile_photo_url": {
"type": [
"string",
"null"
]
},
"company_linkedin_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"meta": {
"type": "object",
"required": [
"cursor",
"hasMore",
"returned",
"totalCount",
"actualCreditCost"
],
"properties": {
"cursor": {
"type": [
"string",
"null"
]
},
"hasMore": {
"type": "boolean"
},
"returned": {
"type": "number"
},
"totalCount": {
"type": "number"
},
"actualCreditCost": {
"type": "number"
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "ok"
}
},
"additionalProperties": false
}
