> ## Documentation Index
> Fetch the complete documentation index at: https://developer.moltsets.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Search for Companies
> The Company Search API lets you search MoltSets' company database by name, domain, industry, employee count, or annual revenue, so you can find and qualify target accounts.
Use `query` for free text company name search, `domain` for an exact lookup by website domain, and the filters (`industry`, `employee_range`, `revenue_range`) to narrow your results. 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 prospect lists for account-based marketing
- Qualify target accounts before outreach
- Enrich CRM records with firmographic data
**Fair Use Policy:**
This API is subject to our Fair Use Policy for Search.
## OpenAPI
````yaml /openapi.json post /search_companies
openapi: 3.1.0
info:
title: MoltSets API
version: 1.0.0
description: >-
MoltSets is an identity resolution API. Use it to resolve emails, LinkedIn
profiles, and IP addresses into enriched contact and company data, including
business and personal emails, mobile phone numbers, and firmographic
details.
servers:
- url: https://api.moltsets.com/api/v1/tools
description: Production
security:
- bearerAuth: []
tags:
- name: Search
description: >-
Search and filter company and business profiles by name, domain, industry,
size, or revenue.
- name: Get Valid Emails
description: Resolve and enrich valid business and personal email addresses.
- name: Get Carrier-Verified Mobile Phones
description: Enrich carrier-verified mobile phone numbers.
- name: Get Full Business Profile
description: Resolve identifiers to full business profiles and company firmographics.
- name: Get Ad Audience
description: >-
Resolve identifiers to hashed email (HEM) and mobile advertising IDs
(MAIDs) for audience matching.
- name: Get Company
description: Resolve IP addresses to company data.
- name: Account
description: Account management tools. Free — do not consume credits.
paths:
/search_companies:
post:
tags:
- Search
summary: Search for Companies
description: >-
The Company Search API lets you search MoltSets' company database by
name, domain, industry, employee count, or annual revenue, so you can
find and qualify target accounts.
Use `query` for free text company name search, `domain` for an exact
lookup by website domain, and the filters (`industry`, `employee_range`,
`revenue_range`) to narrow your results. 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 prospect lists for account-based marketing
- Qualify target accounts before outreach
- Enrich CRM records with firmographic data
**Fair Use Policy:**
This API is subject to our Fair Use Policy for Search.
operationId: searchCompanyProfiles
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: >-
Full-text search across company name only. Do not put
domain, industry, employee size, or revenue here — use the
dedicated filter params for those.
domain:
type: string
description: >-
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
industry:
type: string
description: >-
Exact industry filter. Map the request to one of the
supported values.
enum:
- Professional and Business Services
- Information Technology
- Manufacturing
- Retail
- Health and Pharmaceuticals
- Creative Arts and Entertainment
- Construction
- Marketing & Advertising
- Finance and Banking
- Tourism and Hospitality
- Non-Profit and Social Services
- Food and Beverage
- Real Estate
- Education
- Transportation and Logistics
- Media and Publishing
- Energy
- Automotive
- Government and Public Administration
- Telecommunications
- Agriculture
- Utilities
- Corporate Services
- Insurance
- Banks
- Computer Software
- Pharmaceuticals and Biotechnology
- Aerospace and Defense
- Electronics
- Mining and Metals
employee_range:
type: string
description: >-
Exact employee count range filter. Prefer the numeric ranges
when a size is given.
enum:
- 1-10
- 11-20
- 21-50
- 51-200
- 201-500
- 501-1000
- 1001-5000
- 5001+
- Small
- Mid-Market
- Enterprise
- Unknown
revenue_range:
type: string
description: Exact annual revenue range filter.
enum:
- 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
limit:
type: integer
description: Number of results to return.
default: 10
minimum: 1
maximum: 25
offset:
type: integer
description: >-
Number of results to skip for pagination. Use with limit to
page through results.
default: 0
example:
query: MoltSets
industry: Information Technology
employee_range: 51-200
limit: 10
offset: 0
responses:
'200':
description: Success
content:
application/json:
examples:
found:
summary: Data found
value:
results:
results:
- logo: >-
https://cdn.mixrank.com/md5/0e4e81c8ff584b1ce3e4c3067e8cXXXXX
name: MoltSets
type: Privately Held
domain: moltsets.com
industry: Information Technology
linkedin_url: https://linkedin.com/company/moltsets
exact_revenue: 1200000000
revenue_range: Above $50M
employee_count: 57
employee_range: 51-200
follower_count: 3677
linkedin_company_id: '13223077'
_id: moltsets.com
_score: 15.2394
- name: Acme
type: Privately Held
domain: acme.com
industry: Information Technology
linkedin_url: https://linkedin.com/company/acme
revenue_range: $10M - $20M
employee_count: 90
employee_range: 51-200
follower_count: 121
linkedin_company_id: '82353383'
_id: acme.com
_score: 13.1942
total: 210
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'
external_tokens_used: 0
external_tokens_remaining: 5000
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBadRequest'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorUnauthorized'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorNotFound'
'422':
description: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorInvalidInput'
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorRateLimit'
components:
schemas:
ErrorBadRequest:
type: object
properties:
error:
type: string
example: Bad Request
message:
type: string
example: >-
The server cannot process the request due to a client error (400 Bad
Request).
ErrorUnauthorized:
type: object
properties:
error:
type: string
example: Unauthorized
message:
type: string
example: Invalid API key.
ErrorNotFound:
type: object
properties:
error:
type: string
example: Not Found
message:
type: string
example: No match was found for the data provided.
ErrorInvalidInput:
type: object
properties:
error:
type: string
example: Invalid Input
message:
type: string
example: Message describing the nature of the invalid input.
ErrorRateLimit:
type: object
properties:
error:
type: string
example: Too Many Requests
message:
type: string
example: Rate limit exceeded. Maximum 100 requests per second.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Pass your API key as a Bearer token. Keys follow the format
`ms_XXXXXXXXXXX`.
````