Search / REST API
Search people database
LinkedIn people search through a connected account. Resolve location, industry, company, school, function, and seniority labels first with resolve-linkedin-search-parameters. Classic requires resolved numeric IDs for location, industry, and company filters and rejects unsupported fields. Sales Navigator and Recruiter use their own contracts.
POST /api/leads/searchDeterministic operationParameters
workspaceIdOptional · string- Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
accountIdOptional · string- UUID of the connected LinkedIn account to search through.
paramsRequired · object- Typed API-specific LinkedIn filters. Resolve location, industry, company, school, and function IDs before search.
apiOptional · string- Which LinkedIn API surface to use. Defaults to classic.classic · sales_nav · recruiter
cursorOptional · string- Pagination cursor from a previous response.
limitOptional · number- Max results (1-100, default 25).
curl -X POST "https://app.pipeline.help/api/leads/search" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"params":{}}'Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1,
"description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
},
"accountId": {
"type": "string",
"description": "UUID of the connected LinkedIn account to search through."
},
"params": {
"type": "object",
"properties": {
"api": {
"type": "string",
"enum": [
"classic",
"sales_nav",
"sales_navigator",
"recruiter"
]
},
"category": {
"type": "string",
"enum": [
"people",
"companies"
]
},
"keywords": {
"oneOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"title": {
"oneOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"location": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"industry": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"current_company": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"past_company": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"school": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"network_distance": {
"type": "array",
"items": {
"type": "number",
"enum": [
1,
2,
3
]
}
},
"connections_of": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"followers_of": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"seniority": {
"type": "array",
"items": {
"type": "string"
}
},
"function": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+$"
}
},
"company_headcount": {
"type": "array",
"items": {
"type": "string"
}
},
"saved_search_id": {
"type": "string"
},
"recruiter_network_distance": {
"type": "array",
"items": {
"type": "string",
"enum": [
"F",
"S",
"A"
]
}
},
"can_send_inmail": {
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Typed API-specific LinkedIn filters. Resolve location, industry, company, school, and function IDs before search."
},
"api": {
"type": "string",
"enum": [
"classic",
"sales_nav",
"recruiter"
],
"description": "Which LinkedIn API surface to use. Defaults to classic."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"limit": {
"type": "number",
"description": "Max results (1-100, default 25)."
}
},
"required": [
"params"
]
}