Search for People

The People Search API lets you search MoltSets’ contact database for people by name, job title, company, industry, country, seniority, or department.

Use query for free text search across name, company, title, and headline (this is where names and role keywords go). Use the filters (country, seniority, industry, department or functional_area) to narrow results further. Combining query with filters gives the most precise matches. Every result comes back ranked, with a higher _score meaning a stronger match.

Use this endpoint to:

Build targeted lead lists for outbound sales
Identify decision makers at specific target accounts
Populate outbound sequences with verified contact data

Fair Use Policy: This API is subject to our Fair Use Policy for Search.

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
}
'

import requests

url = "https://api.moltsets.com/api/v1/tools/search_people"

payload = {
    "query": "Account Executive",
    "country": "United States",
    "seniority": "Senior",
    "limit": 10,
    "offset": 0
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'Account Executive',
    country: 'United States',
    seniority: 'Senior',
    limit: 10,
    offset: 0
  })
};

fetch('https://api.moltsets.com/api/v1/tools/search_people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.moltsets.com/api/v1/tools/search_people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'Account Executive',
    'country' => 'United States',
    'seniority' => 'Senior',
    'limit' => 10,
    'offset' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moltsets.com/api/v1/tools/search_people"

	payload := strings.NewReader("{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.moltsets.com/api/v1/tools/search_people")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.moltsets.com/api/v1/tools/search_people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "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",
        "business_email_risk_score": "A",
        "current_industry": "Information Technology",
        "linkedin_slug": "john-smith-123",
        "_id": "john-smith-123",
        "_score": 9.1714
      }
    ],
    "total": 278
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Bad Request",
  "message": "The server cannot process the request due to a client error (400 Bad Request)."
}

{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

{
  "error": "Not Found",
  "message": "No match was found for the data provided."
}

{
  "error": "Invalid Input",
  "message": "Message describing the nature of the invalid input."
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Maximum 100 requests per second."
}

{
  "error": {
    "code": "internal_error",
    "message": "Unexpected connection error."
  },
  "metadata": {}
}

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 requiring either field alone to contain the full string. Job titles and role keywords are matched against both the title field (e.g. "Account Executive", "Head of Sales") and the headline field (e.g. "B2B sales leader"). For seniority level (VP, Director, C-suite) use the seniority filter instead — this field is best suited to specific role or function keywords, combined with other filters for precision, e.g. query: "Account Executive", country: "United States", seniority: "Senior". Categorical values like country or seniority belong in their own filter params rather than this field.

company

string

Company name filter — scopes results to people whose employer's name matches. Analysed match: every word you provide must appear in the company name, so extra words in the stored name are fine ("Acme" matches "Acme Corporation"). Use this when you have a company name but not its domain; if you have the domain, prefer company_domain, which is more precise.

Example:

"MoltSets"

company_domain

string

Company domain filter — scopes results to people at the company with this website domain. Full URLs are normalised automatically ("https://www.acme.com/about" → "acme.com"), so there is no need to strip the protocol or path yourself. The most precise way to target a single company — prefer it over company whenever you know the domain.

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"

state

string

Exact state or region name filter on the person's location. Must match the stored value exactly — full names with standard capitalisation, not abbreviations ("Texas", not "TX"). Combine with country for precision.

Example:

"Texas"

city

string

Exact city name filter on the person's location. Must match the stored value exactly, with standard capitalisation. City names repeat across regions, so combine with state and/or country to disambiguate — e.g. city: "Portland", state: "Oregon". Matches only the exact stored city, not its suburbs — for a metro-area search prefer state or country.

Example:

"Austin"

seniority

enum<string>

Exact seniority level filter (~60% filled). Must match one of the enumerated values exactly, including the space in "C Suite" (not a hyphen).

Available options:

Intern,

Entry,

Senior,

Manager,

Director,

VP,

Head,

C Suite,

Owner,

Partner

industry

enum<string>

Exact industry filter (~60% filled). Must match one of the enumerated values exactly, including capitalisation and punctuation (e.g. the ampersand in "Marketing & Advertising").

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>

Exact department filter (~60% filled). Shares its underlying data with functional_area — use one or the other, not both. Must match one of the enumerated values exactly, including capitalisation and punctuation (e.g. the ampersand in "Medical & Health").

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). Shares its underlying data with department — use one or the other, not both.

Available options:

Operations,

Sales,

Information Technology,

Education,

Engineering,

Finance,

Medical & Health,

Marketing,

Human Resources,

Design,

Consulting,

Legal

employee_range

enum<string>

Exact employee-count range filter on the person's current employer — finds people at companies of a certain size without needing to name a specific company. Values are fixed bucket ranges (e.g. "51-200", "1001-5000"). Legacy values ("Small", "Mid-Market", "Enterprise", "Unknown") also exist in older records but have far less coverage than the numeric ranges. Combine with other filters, e.g. seniority: "VP", employee_range: "51-200".

Available options:

1-10,

11-20,

21-50,

51-200,

201-500,

501-1000,

1001-5000,

5001+,

Small,

Mid-Market,

Enterprise,

Unknown

revenue_range

enum<string>

Exact annual revenue range filter on the person's current employer — finds people at companies of a certain revenue without needing to name a specific company. Values are fixed bucket ranges. "$1 - $1M" is a legacy format equivalent to "$500k - $1M" but with far fewer records.

Available options:

Below $500k,

$500k - $1M,

$1M - $5M,

$5M - $10M,

$10M - $20M,

$20M - $50M,

Above $50M,

$50M - $100M,

$100M - $250M,

$250M - $500M,

$500M - $1B,

$1B - $2.5B,

$2.5B - $5B,

Over $5B,

$1 - $1M

naics_code

string

Exact NAICS industry code filter on the person's current employer (~50% filled). Works at any level of the hierarchy, from the 2-digit sector ("23" = Construction, "54" = Professional Services) through to the 6-digit national industry ("541120" = Offices of Notaries, "511210" = Software Publishers). Use a short code for broad industry targeting and a longer code for precision. The most standardised industry filter available — prefer it over industry when you need fine-grained targeting.

Example:

"541120"

linkedin_industry

string

Exact LinkedIn industry label filter on the person's current employer (~50% filled). Uses LinkedIn's own ~150-value industry vocabulary, which is far finer-grained than the 21 buckets in industry. Must match the stored label exactly, with standard capitalisation — for example "Software Development", "Hospitality", "Legal Services", "Wellness and Fitness Services", "Construction", "Staffing and Recruiting". Use when a niche industry cannot be expressed by the broad industry buckets.

Example:

"Software Development"

limit

integer

default:10

Number of results to return (default: 10, max: 25).

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

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
}
'

import requests

url = "https://api.moltsets.com/api/v1/tools/search_people"

payload = {
    "query": "Account Executive",
    "country": "United States",
    "seniority": "Senior",
    "limit": 10,
    "offset": 0
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'Account Executive',
    country: 'United States',
    seniority: 'Senior',
    limit: 10,
    offset: 0
  })
};

fetch('https://api.moltsets.com/api/v1/tools/search_people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.moltsets.com/api/v1/tools/search_people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'Account Executive',
    'country' => 'United States',
    'seniority' => 'Senior',
    'limit' => 10,
    'offset' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moltsets.com/api/v1/tools/search_people"

	payload := strings.NewReader("{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.moltsets.com/api/v1/tools/search_people")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.moltsets.com/api/v1/tools/search_people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"Account Executive\",\n  \"country\": \"United States\",\n  \"seniority\": \"Senior\",\n  \"limit\": 10,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "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",
        "business_email_risk_score": "A",
        "current_industry": "Information Technology",
        "linkedin_slug": "john-smith-123",
        "_id": "john-smith-123",
        "_score": 9.1714
      }
    ],
    "total": 278
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Bad Request",
  "message": "The server cannot process the request due to a client error (400 Bad Request)."
}

{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

{
  "error": "Not Found",
  "message": "No match was found for the data provided."
}

{
  "error": "Invalid Input",
  "message": "Message describing the nature of the invalid input."
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Maximum 100 requests per second."
}

{
  "error": {
    "code": "internal_error",
    "message": "Unexpected connection error."
  },
  "metadata": {}
}

Search

Get Valid Emails

Get Carrier-Verified Mobile Phones

Reverse Lookups

Get Ad Audience

Get LinkedIn

Get Company

Account

Search for People

Authorizations

Body

Response