Search for LinkedIn profiles using natural language queries with pagination support
Parameter | Type | Required | Description |
---|---|---|---|
query | string | Yes* | Natural language search query (*Required for new searches, optional when using search_id) |
limit | integer | No | Maximum number of results (default: 30, max: 100) |
companies | array[string] | No | List of company names to filter results by |
schools | array[string] | No | List of school names to filter results by |
advanced_filtering | boolean | No | Enable AI agent-based filtering for higher quality results (default: true) |
search_id | string | No | ID from a previous search to continue pagination |
offset | integer | No | Number of results to skip for pagination (default: 0) |
Query | Description |
---|---|
”software engineers at major tech companies” | Find engineers at leading technology companies |
”product managers with MBA” | Find PMs with MBA education |
”founders in fintech” | Find startup founders in financial technology |
”data scientists with PhD” | Find PhD-level data scientists |
”marketing directors in healthcare” | Find marketing leaders in health industry |
Status Code | Description |
---|---|
400 | Bad Request - Invalid parameters or limit exceeded |
401 | Unauthorized - API key missing or invalid |
422 | Validation Error - Missing required ‘query’ parameter |
500 | Internal Server Error - Search processing error |
503 | Service Unavailable - Search service temporarily down |
advanced_filtering
is enabled: 1 credit per result returned (no base charge)advanced_filtering
is enabled:
limit
due to quality filteringsearch_id
that can be used to paginate through resultssearch_id
with the offset
parameter to get subsequent pagessearch_id
do not require the original query
parametersearch_id
from the initial search with offset=20
and limit=20
API key authentication. Keys start with 'lk_'.
Natural language search query to find LinkedIn profiles (e.g., 'software engineers at tech companies', 'product managers with MBA'). Required for new searches, optional when using search_id for continuation
Maximum number of profiles to return in the response (1-100)
1 <= x <= 100
List of company names to filter results by
List of school names to filter results by
Enable AI agent-based filtering to improve result quality. When enabled, an AI agent reviews all results before returning them, which may return fewer results than the requested limit but with higher relevance and quality
ID from a previous search to continue pagination. When provided, uses the same search criteria and query from the original search
Number of results to skip for pagination. Used with search_id to get subsequent pages of results
x >= 0
Successful response
The response is of type object
.