Skip to main content
POST
/
search_people
Search for People
curl --request POST \
  --url https://api.moltsets.com/api/v1/tools/search_people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "Account Executive",
  "country": "United States",
  "seniority": "Senior",
  "limit": 10,
  "offset": 0
}
'
{
  "results": {
    "results": [
      {
        "title": "Senior Associate - Technical Director",
        "company": {
          "name": "MoltSets",
          "size": "57",
          "revenue": "1200000000",
          "industry": "Information Technology",
          "logo_url": "https://cdn.mixrank.com/md5/0bb6181a215bac707d7af3276be5XXXXX",
          "website_url": "https://moltsets.com",
          "linkedin_url": "https://linkedin.com/company/moltsets"
        },
        "country": "United States",
        "headline": "Senior Associate - Technical Director @ MoltSets",
        "full_name": "John Smith",
        "last_name": "Smith",
        "seniority": "Senior",
        "first_name": "John",
        "linkedin_url": "https://linkedin.com/in/john-smith-123",
        "business_email": "john.smith@example.com",
        "current_industry": "Information Technology",
        "linkedin_slug": "john-smith-123",
        "_id": "john-smith-123",
        "_score": 9.1714
      }
    ],
    "total": 278
  },
  "status": "ok",
  "metadata": {
    "tokens_charged": 1,
    "tokens_remaining": "unlimited",
    "daily_results_remaining": 9876
  }
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token. Keys follow the format ms_XXXXXXXXXXX.

Body

application/json
​
query
string

Full-text search across full_name, first_name, last_name, company name, title (~85% filled), and headline (~65% filled) using cross-field matching. Multi-word queries distribute terms across fields — "John Smith" matches first_name: John AND last_name: Smith rather than either alone. Job title and role keywords belong here — both the title field (e.g. "Account Executive", "Head of Sales", "Data Scientist", "Software Engineer", "Marketing Lead") and the headline field (e.g. "Helping SaaS companies grow", "B2B sales leader") are searched. For seniority level (VP, Director, C-suite) use the seniority filter instead; use this field for specific role or function keywords. Combine with filters for precision — e.g. query: "Account Executive", country: "United States", seniority: "Senior". Extract names, company names, and role keywords from the human's request. Examples: "Jane Doe", "Account Executive Salesforce", "Head of Sales fintech", "Data Scientist", "software engineer Netflix", "recruiter London". Do NOT put categorical values like country or seniority here — use the dedicated filter params for those.

​
company
string

Full-text search across company name only. Do not put domain, industry, employee size, or revenue here — use the dedicated filter params for those.

Example:

"moltsets.com"

​
company_domain
string

Exact domain filter. Omit the protocol (no https://). Prefer this over query when you have a known domain — it's a precise match.

Example:

"moltsets.com"

​
country
string

Exact country name filter (~99% filled — most reliable filter). Must match the stored value exactly. Top values by volume: "United States", "India", "United Kingdom", "Brazil", "Canada", "France", "Mexico", "Australia", "China", "Spain", "Netherlands", "Italy", "Indonesia", "Germany", "Philippines", "Turkey", "South Africa", "Saudi Arabia", "Argentina", "Singapore", "United Arab Emirates", "Colombia", "South Korea", "Malaysia", "Poland", "Belgium", "Switzerland", "Ireland", "Sweden", "Denmark", "Norway", "Austria", "Portugal", "Israel", "New Zealand", "Finland", "Greece", "Hungary", "Romania", "Ukraine". Use the full English country name.

Example:

"United States"

​
seniority
enum<string>

Exact seniority level filter (~60% filled). Map the human's language to one of these exact values: "Intern" (intern, trainee, student ambassador), "Entry" (entry-level, junior, associate, coordinator, analyst, assistant — most common), "Senior" (senior, experienced individual contributor), "Manager" (manager, supervisor, team lead, head of small team), "Director" (director, senior director), "VP" (vice president, VP, SVP, EVP), "Head" (head of department, chief of staff), "C Suite" (CEO, CTO, CFO, COO, CMO, CRO, president, chief), "Owner" (owner, founder, co-founder, principal), "Partner" (partner, managing partner). Use the exact string shown — note "C Suite" has a space, not a hyphen.

Available options:
Intern,
Entry,
Senior,
Manager,
Director,
VP,
Head,
C Suite,
Owner,
Partner
​
industry
enum<string>

This field takes one exact value from the fixed list below, and it's currently about 60% filled in. When someone describes their industry in their own words, find the closest match from the list and type it in exactly as shown, including the capitalisation, spelling, and any punctuation (for example the ampersand in "Marketing & Advertising"). Use the cues in brackets to decide which value fits:

Information Technology (tech, software, IT, SaaS, startup) Professional and Business Services (consulting, business services, staffing) Finance and Banking (finance, banking, fintech, investment, insurance) Education (school, university, edtech, e-learning) Health and Pharmaceuticals (healthcare, pharma, biotech, medical, hospital) Manufacturing (manufacturing, industrial, production) Government and Public Administration (government, public sector, military) Retail (retail, e-commerce, consumer goods) Food and Beverage (food, beverage, restaurant, CPG) Creative Arts and Entertainment (media, entertainment, arts, gaming) Non-Profit and Social Services (nonprofit, NGO, charity, social) Transportation and Logistics (logistics, supply chain, shipping, trucking) Construction (construction, real estate development, architecture) Tourism and Hospitality (travel, hotel, tourism, hospitality) Energy (energy, oil, gas, renewables, utilities) Marketing & Advertising (marketing, advertising, PR, digital marketing) Telecommunications (telecom, wireless, broadband) Real Estate (real estate, property) Automotive (automotive, car, vehicle) Media and Publishing (media, publishing, journalism, news) Agriculture (agriculture, farming, agtech)

Available options:
Information Technology,
Professional and Business Services,
Finance and Banking,
Education,
Health and Pharmaceuticals,
Manufacturing,
Government and Public Administration,
Retail,
Food and Beverage,
Creative Arts and Entertainment,
Non-Profit and Social Services,
Transportation and Logistics,
Construction,
Tourism and Hospitality,
Energy,
Marketing & Advertising,
Telecommunications,
Real Estate,
Automotive,
Media and Publishing,
Agriculture
​
department
enum<string>

This field takes one exact value from the fixed list below, and it's currently about 60% filled in. Note that it shares its data with the functional_area field, so populate one or the other, not both. When someone describes their department in their own words, find the closest match and type it in exactly as shown, including capitalisation and punctuation (for example the ampersand in "Medical & Health"). Use the cues in brackets to decide which value fits:

Operations (ops, general, administration, management — this is the most common one) Sales (sales, business development, account management) Information Technology (IT, tech, software, engineering — use this for IT and tech roles) Education (teaching, academic, training) Engineering (engineering, R&D, product engineering) Finance (finance, accounting, treasury) Medical & Health (healthcare, medical, nursing, clinical) Marketing (marketing, growth, demand gen, content) Human Resources (HR, people, talent, recruiting) Design (design, UX, creative) Consulting (consulting, advisory, strategy) Legal (legal, compliance, counsel)

Available options:
Operations,
Sales,
Information Technology,
Education,
Engineering,
Finance,
Medical & Health,
Marketing,
Human Resources,
Design,
Consulting,
Legal
​
functional_area
enum<string>

Exact functional area filter (~60% filled, co-populated with department — same doc counts, same enumerated values, sourced together). Use department or functional_area, not both. Use the exact string shown.

Available options:
Operations,
Sales,
Information Technology,
Education,
Engineering,
Finance,
Medical & Health,
Marketing,
Human Resources,
Design,
Consulting,
Legal
​
limit
integer
default:10

Number of results to return (default: 10, max: 25). Increase when the human wants more options.

Required range: 1 <= x <= 25
​
offset
integer
default:0

Number of results to skip for pagination (default: 0). Use with limit to page through results — e.g. offset: 10 to get the second page of 10 results.

Response

Success