Employee Finder
Browse employees at one company with role, seniority, and geography filters.
POST
/v2/search/employee-finderRequest
curl -X POST "https://moltsetz.vercel.app/v2/search/employee-finder" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_linkedin_url": "https://www.linkedin.com/company/openai",
"job_level": [
"Director",
"CXO"
],
"max_results": 10,
"page": 1
}'Body
| Field | Type | Required | Description and limits |
|---|---|---|---|
company_linkedin_url | string | Required | Canonical or trailing-slash LinkedIn company profile URL.linkedin.com/company/{slug} |
people | object | Optional | Person filters: job_title, job_function, job_level, country_code, continent, sales_region, or min_connections_count.At least one people or company filter is required |
max_results | integer | Optional | Maximum records returned.1–100; defaults to 10 |
page | integer | Optional | One-based page number.Positive integer; defaults to 1 |
Pagination
Use a positive one-based page value. Each page contains up to max_results records.
Credits
One request credit is recorded only when this endpoint returns a 2xx response. Authentication, validation, rate-limit, and not-found responses do not consume a credit.
Response
| Field | Type | Description |
|---|---|---|
page | integer | Current page number. |
max_results | integer | Applied page size. |
results | array | The records returned for this page. |
results_length | integer | Number of records in results. |
Example response
{
"page": 1,
"max_results": 10,
"results_length": 10,
"results": []
}Errors
| Status | Code | When |
|---|---|---|
422 | INVALID_INPUT | A required value is missing, malformed, or outside its documented limits. |
401 | UNAUTHORIZED | The x-api-key header is missing or invalid. |
402 | CREDITS_EXHAUSTED | A limited plan has no request credits remaining. |
405 | METHOD_NOT_ALLOWED | The endpoint is called with an unsupported HTTP method. |
429 | RATE_LIMIT_EXCEEDED | The API key exceeds its plan-wide requests-per-second limit. |
500 | DATA_SERVICE_ERROR | The data service cannot complete the request. |
{
"success": false,
"error": {
"code": "INVALID_INPUT",
"message": "A field-specific validation message"
}
}