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 ~150-value vocabulary — 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`
`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

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 and role keywords here
`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	~150-value vocabulary, 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
`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, 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 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`

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: "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
// 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