Find Companies and Contacts

MoltSets has two search endpoints: one for companies and one for contacts. Both accept the same core filters and return ranked results. Use them when you want to find records matching a profile rather than enrich a specific person or company you already know. If you already have a LinkedIn URL, email, or IP address and want to enrich it, see I Have X, I Want Y.

Search results are capped at 25 per call (limit max 25, default 10). Free-plan accounts are capped at 5 per call (limit max 5) and get 100 search results total, lifetime. Use limit and offset together to paginate through larger result sets. See Pagination below for examples.Neither endpoint supports a founding-year filter. Industry and range filters use fixed enumerations — see the API reference for accepted values.

Available Filters

The two endpoints share most of their vocabulary. industry, employee_range, revenue_range, naics_code, linkedin_industry, country, state, limit, and offset appear on both; the rest are endpoint-specific.

`search_companies`

Filter	What it does	Notes
`query`	Free-text search across company name	Do not use for domain, industry, or size — use the dedicated filters for those
`domain`	Exact company domain match	Full URLs are normalised automatically (`https://www.acme.com/about` → `acme.com`). Prefer this over `query` when you have a known domain
`industry`	Filter by industry	Fixed enumeration — see Search Company Profiles for accepted values
`linkedin_industry`	Filter by LinkedIn’s industry label	LinkedIn’s own vocabulary, hundreds of labels — finer-grained than `industry`
`naics_code`	Filter by NAICS industry code	Matches at any hierarchy level — 2-digit sector through 6-digit national industry
`employee_range`	Filter by headcount band	Fixed enumeration — see Search Company Profiles for accepted values
`revenue_range`	Filter by annual revenue band	Fixed enumeration — see Search Company Profiles for accepted values
`country`	Exact country name filter	Company location is team-derived — see the caveat below
`state`	Exact state or region filter	Full names, not abbreviations. Combine with `country`
`exclude_domain`	Removes specific companies	Your suppression list — pass the accounts you already have. Takes a list
`exclude_industry`	Removes whole industries	Same values as `industry`. Takes a list
`exclude_employee_range`	Removes headcount bands	Same values as `employee_range`. Takes a list
`exclude_revenue_range`	Removes revenue bands	Same values as `revenue_range`. Takes a list
`limit`	Number of results to return	Max 25 per call, default 10 (Free plan: max 5)
`offset`	Number of results to skip	Use with `limit` to paginate

Excluded companies are never returned, so they cost you no tokens and no search records — always cheaper than filtering results yourself. Exclusions narrow a search but can’t be the whole search: at least one positive input is still required.

country and state on search_companies describe where the company’s team is based. That’s accurate for the small companies that dominate the index, but large multinationals are attributed to a single one of their offices — combine location with other filters rather than relying on it alone for global companies.

`search_people`

Filter	What it does	Notes
`query`	Free-text search across name, company, title, and headline	Put names here. For a job title use `title` instead
`title`	Job title filter	The precise way to search by role — matches the title field alone (~85% filled)
`company`	Company name filter	Scopes to the person’s employer. Every word you supply must appear in the name (`Acme` matches `Acme Corporation`)
`company_domain`	Exact company domain match	Full URLs are normalised automatically. Prefer this over `company` when you have a known domain
`country`	Exact country name filter	Most reliable filter (~99% filled). Must match the stored value
`state`	Exact state or region filter	Full names, not abbreviations — `Texas`, not `TX`
`city`	Exact city name filter	Matches the exact stored city, not its suburbs. Combine with `state`/`country` to disambiguate
`seniority`	Exact seniority level	Fixed enumeration — see Search Business Profiles for accepted values
`industry`	Filter by industry	Fixed enumeration — see the API reference for accepted values
`linkedin_industry`	Filter by LinkedIn’s industry label	Hundreds of labels, finer-grained than `industry`
`naics_code`	Filter by NAICS industry code	Matches at any hierarchy level
`department` / `functional_area`	Team or function filter	Co-populated from the same data — use one or the other, never both
`employee_range`	Filter by employer headcount band	Applies to the person’s current employer
`revenue_range`	Filter by employer revenue band	Applies to the person’s current employer
`exclude_company_domain`	Removes people at specific companies	Your suppression list — pass the accounts you already have. Takes a list
`exclude_country`	Removes whole countries	Same values as `country`. Takes a list
`exclude_state`	Removes states or regions	Same values as `state`. Takes a list
`exclude_industry`	Removes whole industries	Same values as `industry`. Takes a list
`exclude_seniority`	Removes seniority levels	Same values as `seniority`. Takes a list
`exclude_employee_range`	Removes employer size bands	Same values as `employee_range`. Takes a list
`limit`	Number of results to return	Max 25 per call, default 10 (Free plan: max 5)
`offset`	Number of results to skip	Use with `limit` to paginate

Combine query with filters for best precision — filters cost nothing extra to attach, and a search built from filters alone runs far cheaper than one driven by free text. See Searching for People and Searching for Companies for the full guidance. Results are ranked by relevance — higher _score means a stronger match.

Finding Companies

Use search_companies when your output is a list of companies. Returns name, domain, industry, employee count and range, revenue range, LinkedIn URL, city/state/country, NAICS codes and titles, LinkedIn industry, and logo URL.

I want…	Type in Claude…	Filters used
A specific company by domain	Find the company record for acme.com	`domain`
Companies matching a name	Find company profiles matching Acme	`query`
Companies in a specific industry	Find information technology companies	`industry`
Companies by industry and headcount	Find information technology companies with 51–200 employees	`industry`, `employee_range`
Companies by industry and revenue	Find computer software companies with revenue above $50M	`industry`, `revenue_range`
Companies matching an ICP	Find privately held computer software companies with 201–500 employees and revenue between $10M and$ 50M	`industry`, `employee_range`, `revenue_range`
Companies minus the ones you have	Find information technology companies with 51–200 employees, but not acme.com or stripe.com	`industry`, `employee_range`, `exclude_domain`
Companies minus a segment	Find software companies but skip anyone under 21 employees	`industry`, `exclude_employee_range`

Finding Contacts

Use search_people when your output is a list of people. Returns name, title, seniority, location, LinkedIn URL, business email with its risk score and validation date, and a nested company object carrying domain, size, industry, NAICS codes, and logo URL.

I want…	Type in Claude…	Filters used
All contacts at a specific company	Find contacts at acme.com	`company_domain`
Contacts in a specific role	Find account executives in the United States	`title`, `country`
Contacts at a named company	Find contacts at Acme	`company`
Contacts in a specific industry	Find contacts at information technology companies	`industry`
Decision-makers at a company	Find senior contacts at acme.com	`company_domain`, `seniority`
Contacts in a specific team	Find engineering contacts at acme.com	`company_domain`, `department`
Contacts in an industry and country	Find marketing contacts at software companies in the United States	`industry`, `country`
Contacts in a specific city	Find sales contacts in Austin, Texas	`city`, `state`
Contacts at companies of a given size	Find VPs at companies with 51–200 employees	`seniority`, `employee_range`
Contacts matching an ICP	Find senior engineering contacts at information technology companies in the United States	`industry`, `seniority`, `department`, `country`
Contacts minus the accounts you have	Find VPs at software companies, but not at acme.com or stripe.com	`industry`, `seniority`, `exclude_company_domain`
Contacts anywhere but one region	Find sales contacts in the United States outside California	`country`, `exclude_state`

To target contacts by company size or revenue, filter directly on search_people — employee_range and revenue_range apply to the person’s current employer, so you can find people at companies of a given size without naming a company. Chain through search_companies only when you also want the company records themselves.

Pagination

Each call returns a maximum of 25 results (5 on the Free plan). To pull more, increment offset by 25 on each subsequent call (5 on the Free plan). Free-plan accounts have a lifetime cap of 100 search results total, so pagination is only useful up to that ceiling. The total number of matching records is returned in the total field on every response — use this to determine how many pages exist before you start paginating.

Using with MCP

Once MoltSets is connected to Claude, describe what you want and Claude will call the right search endpoint with the right filters. Exact company lookup

Look up the company record for acme.com

ICP company list

Find computer software companies with 51–200 employees and revenue between $10M and $50M

ICP contact list

Find senior contacts at information technology companies in the United States

Paginated pull

Find senior contacts at information technology companies in the United States. Get the first 25, then keep fetching the next page until you have 100 results.

Paginated offset/skip

Find senior contacts at information technology companies in the United States. Offset by 50 then keep fetching the next page until you have 100 additional results.

Using with the API

All search requests follow the same shape. Pass your filters in the request body and increment offset to paginate. Find companies matching an ICP

const response = await fetch("https://api.moltsets.com/api/v1/tools/search_companies", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    industry: "Information Technology",
    employee_range: "51-200",
    revenue_range: "$10M - $20M",
    limit: 25,
    offset: 0
  })
});

const data = await response.json();
// data.results.results — array of matching companies
// data.results.total — total matching records across all pages

Find contacts at a specific company

const response = await fetch("https://api.moltsets.com/api/v1/tools/search_people", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    company_domain: "acme.com",
    limit: 25,
    offset: 0
  })
});

const data = await response.json();
// data.results.results — array of matching contacts
// data.results.total — total matching records across all pages

Paginating through results

total stops counting at 10,000. A total of 10000 means at least 10,000 matches, not exactly 10,000 — don’t plan a pull off it. offset + limit is capped at 10,000 too, so paging can’t reach record 10,001. For a larger list, split the search into narrower slices and walk each one separately.

async function fetchAllResults(filters, endpoint) {
  const results = [];
  let offset = 0;
  const limit = 25;

  while (true) {
    const response = await fetch(`https://api.moltsets.com/api/v1/tools/${endpoint}`, {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ ...filters, limit, offset })
    });

    const data = await response.json();
    const page = data.results.results;

    results.push(...page);

    if (results.length >= data.results.total || page.length < limit) break;

    offset += limit;

    // `offset + limit` can't exceed 10,000 — the search window is capped there
    if (offset + limit > 10000) break;
  }

  return results;
}

// Example: fetch all contacts at acme.com
// note: search_people scopes by `company_domain`; `domain` is the search_companies filter
const contacts = await fetchAllResults({ company_domain: "acme.com" }, "search_people");

Getting Started

MoltSets' Data

Use Cases

Best Practices

Integrations

Available Filters

`search_companies`

`search_people`

Finding Companies

Finding Contacts

Using with MCP

Using with the API

​Available Filters

​search_companies

​search_people

​Finding Companies

​Finding Contacts

​Pagination

​Using with MCP

​Using with the API

Available Filters

`search_companies`

`search_people`

Finding Companies

Finding Contacts

Pagination

Using with MCP

Using with the API