Find People

Build people lists by combining contact fields with the current employer snapshot on each contact record.

When to use it

Use POST /v2/search/people when you need a list of contacts by role, seniority, geography, or current employer. The endpoint searches the contacts index and can return company details such as company.name, company.domain, company.industry, and company.about with each person.

How it works

• Send at least one supported people or company filter.
• Use exact normalized values for seniority, functions, country codes, continents, regions, and company type.
• Use max_results from 1 to 100. Pagination uses the opaque cursor from the previous response.
• The nested company object is an employer snapshot stored on the person record, not a standalone company enrichment response.

Working filters

Company filters inside Find People

People filters

Accepted values

Use these canonical exact values in list filters. Title and domain filters can use include/exclude arrays.

Response shape

Each result includes normalized person fields and, when present on the contact record, a compact employer object.

Employer snapshot fields

Examples

Role and domain

curl -X POST "https://moltsetz.com/v2/search/people" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company": {
    "domain": {
      "include": [
        "openai.com"
      ]
    }
  },
  "people": {
    "job_title": {
      "include": [
        "CEO"
      ],
      "exclude": [
        "Assistant"
      ]
    }
  },
  "max_results": 10
}'

Seniority, function, and geography

curl -X POST "https://moltsetz.com/v2/search/people" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "people": {
    "job_level": [
      "VP",
      "Director"
    ],
    "job_function": [
      "Sales & Business Development"
    ],
    "country_code": [
      "US"
    ],
    "sales_region": [
      "NORAM"
    ]
  },
  "max_results": 25
}'

Employer type

curl -X POST "https://moltsetz.com/v2/search/people" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company": {
    "type": [
      "Privately Held"
    ],
    "country_code": [
      "US"
    ]
  },
  "people": {
    "job_title": {
      "include": [
        "Head of Growth"
      ]
    }
  },
  "max_results": 10
}'

Not yet supported

These fields exist in the wider data model or company-focused docs, but should not be used as Find People filters until the API maps them in the contacts query.

• company.industry, company.employee_range, and company.sales_region as People Search filters.
• company.hq.*, revenue, funding, NAICS, SIC, traffic, ad spend, technologies, and open roles as People Search filters.
• people.education, people.skills, people.certifications, and people.languages as People Search filters.