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 city/region or founding-year filters. employee_range and revenue_range apply to search_companies only — search_people cannot filter by company size or revenue. Industry and range filters use fixed enumerations — see the API reference for accepted values.

Available Filters

The two endpoints take different filter sets. industry, limit, and offset are shared; 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	Omit the protocol — use `acme.com` not `https://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
`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
`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

`search_people`

Filter	What it does	Notes
`query`	Free-text search across name, company, title, and headline	Put names and role keywords here
`company`	Free-text company name match	Company name only — not domain, industry, or size
`company_domain`	Exact company domain match	Omit the protocol — use `acme.com`. 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
`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
`department` / `functional_area`	Team or function filter	Fixed enumerations — see the API reference for accepted values
`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. 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, revenue range, LinkedIn URL, and follower count.

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`

Finding Contacts

Use search_people when your output is a list of people. Returns name, title, seniority, LinkedIn URL, business email, company name, and firmographic data.

I want…	Type in Claude…	Filters used
All contacts at a specific company	Find contacts at acme.com	`company_domain`
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 matching an ICP	Find senior engineering contacts at information technology companies in the United States	`industry`, `seniority`, `department`, `country`

To target contacts by company size or revenue, filter companies first with search_companies (employee_range / revenue_range), then run search_people on each returned domain — search_people has no size or revenue filter of its own.

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: "Computer Software",
    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

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

  return results;
}

// Example: fetch all contacts at acme.com
const contacts = await fetchAllResults({ domain: "acme.com" }, "search_people");

Getting Started

MoltSets' Data

Use Cases

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