Find People

Search people and their employers together using company and person-level filters.

POST/v2/search/people

Request

curl -X POST "https://moltsetz.vercel.app/v2/search/people" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company": {
    "industry": {
      "include": [
        "Software"
      ]
    },
    "country_code": [
      "US"
    ]
  },
  "people": {
    "job_title": {
      "include": [
        "Growth"
      ]
    },
    "job_level": [
      "Director"
    ]
  },
  "max_results": 10
}'

Body

Field	Type	Required	Description and limits
`company`	object	Optional	Company filters: keywords/name, industry, country_code, continent, sales_region, type, or employee_range.Must contain at least one non-empty supported filter
`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
`cursor`	string	Optional	Opaque cursor returned by the previous page.Base64url cursor; omit for the first page

Pagination

Use the returned cursor unchanged in the next request. Omitting cursor starts at the first page. max_results is 1–100.

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
`results`	array	The records returned for this page.
`results_length`	integer	Number of records in results.
`cursor`	string \| null	Cursor for the next page, or null when no full next page is available.

Example response

{
  "results_length": 10,
  "cursor": "MTA",
  "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"
  }
}

All endpoints Create an API key