Skip to main content
POST
Search for Companies

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 company name only. Do not put domain, industry, employee size, or revenue here — use the dedicated filter params for those.

domain
string

Exact company domain filter. Full URLs are normalised automatically ("https://www.acme.com/about" → "acme.com"), so there is no need to strip the protocol or path yourself. Prefer this over query when you know the domain, since it is a precise match rather than a text search.

Example:

"moltsets.com"

industry
enum<string>

Exact industry filter. These 22 buckets are the only supported values, and must match exactly, including capitalisation and punctuation (note the ampersand in "Marketing & Advertising"). For a niche the buckets cannot express — insurance carriers, aerospace, mining — use linkedin_industry instead.

Available options:
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,
Government and Public Administration,
Automotive,
Telecommunications,
Agriculture,
Utilities
employee_range
enum<string>

Exact employee count range filter. These eight numeric bands are the only supported values — "1-10" holds the most records by a wide margin, "5001+" the fewest.

Available options:
1-10,
11-20,
21-50,
51-200,
201-500,
501-1000,
1001-5000,
5001+
revenue_range
enum<string>

Exact annual revenue range filter. These seven bands are the only supported values — "$500k - $1M" is the most common. "Above $50M" is a flat catch-all for all revenue over $50M; there is no finer band above it, so use it for any large-enterprise revenue target.

Available options:
Below $500k,
$500k - $1M,
$1M - $5M,
$5M - $10M,
$10M - $20M,
$20M - $50M,
Above $50M
naics_code
string

Exact NAICS industry code filter (~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.

Example:

"541120"

linkedin_industry
string

Exact LinkedIn industry label filter (~85% filled). Uses LinkedIn's own industry vocabulary, which is far finer-grained than the 22 buckets in industry. Must match the stored label exactly, with standard capitalisation — for example "Software Development", "Hospitality", "Legal Services", "Staffing and Recruiting", "Wellness and Fitness Services".

Example:

"Software Development"

country
string

Exact country name filter on the company's location. Use the full English country name. Note that company location is derived from where the company's team is based: this is accurate for the small companies that dominate the index, but large multinationals are attributed to a single one of their offices — combine it with other filters rather than relying on location alone when targeting global companies.

Example:

"United States"

state
string

Exact state or region name filter on the company's location. Full names with standard capitalisation ("Texas", not "TX"). Combine with country for precision. Location is team-derived in the same way as country, so it is most accurate for smaller companies.

Example:

"Texas"

exclude_domain
string[]

Company domains to exclude. Any company on this list is dropped from the results — this is the suppression list, so pass the accounts you already have (existing customers, current vendors, your own company) and they never come back. Full URLs are normalised automatically, exactly as with domain. Excluded records cost you nothing: they consume no tokens and no fair use records, so excluding here is always cheaper than filtering the results yourself.

Example:
exclude_industry
string[]

Industries to exclude. Companies in any listed industry are dropped. Accepts the same values as industry. Exclusion only removes companies that positively carry one of these values, so companies with no industry on record still appear in your results.

Example:
exclude_employee_range
string[]

Employee count bands to exclude. Companies in any listed band are dropped. Accepts the same values as employee_range — for example ["1-10", "11-20"] to skip the very smallest companies, or ["5001+"] to skip enterprises.

Example:
exclude_revenue_range
string[]

Revenue bands to exclude. Companies in any listed band are dropped. Accepts the same values as revenue_range — for example ["Below $500k"] to skip the smallest companies, or ["Above $50M"] to skip large enterprises.

Example:
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