Field normalization

Use these canonical field names and accepted values when filtering people and employer snapshots in the v2 APIs.

How normalization works

moltsetz stores B2B records in Elasticsearch and returns a normalized JSON shape from each endpoint. Exact list filters must use values from the current index, including capitalization and punctuation, especially for country codes, regions, seniority, company type, and departments.

• Use include/exclude objects for keyword-style filters such as company.domain, company.name, and people.job_title.
• Keep max_results between 1 and 100. Cursors are opaque and should be sent back unchanged.
• When a narrow filter returns no results, run a broader request first and copy returned normalized values into the next request.

Accepted value lists

These lists are generated from the current production Elasticsearch indexes and show values users can put into exact normalized fields.

Find People filters

These fields are supported by Find People. Employer filters use the current company snapshot stored on each contact record.

Employer filters

Person filters

Returned people fields

People search returns normalized person fields plus a nested company object when employer data is available.

Returned employer snapshot fields

These fields can appear inside results[].company from Find People.

Examples

People search request

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"
      ]
    }
  },
  "max_results": 2
}'

Observed normalized fields from a live response:

{
  "job_function": "General Business & Management",
  "job_level": "C-Team",
  "location": {
    "country_code": "US"
  },
  "company": {
    "name": "OpenAI",
    "domain": "openai.com",
    "about": "AI research and deployment company.",
    "industry": "Software Development"
  }
}

Unsupported Find People filters

Do not use these fields as Find People filters until the API maps them in the contacts query.

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

Troubleshooting