Company / Similar

Preview

Cost: FREE - No credits deducted

Requirements: Requires Scale plans

Notice: Returns top 25 results only

Preview search for similar companies based on given criteria. You can search by domain, industry, employees, revenue, founded year, and more. This endpoint returns the top 25 similar companies for free, perfect for previewing results before running a full similar search.

post/companies/similar/preview

Request

  • Base URL: https://api.companyenrich.com
  • URL: https://api.companyenrich.com/companies/similar/preview
  • Auth: API key in header Authorization

Query parameters

waitForEnrichmentboolean

Whether to wait for on-demand enrichment when a seed company is not stored yet. When false, valid missing domains are scheduled for background enrichment and the request returns a 404 if any seed company is missing, so it can be retried with a stable seed set later. This only controls seed-company enrichment; preparing a similarity vector for a stored company may still require processing.

Request body

domainsstring[]

The domains to find similar companies for. Up to 10 domains are allowed.

similarityWeightnumber double

The similarity weight to apply to the results. Must be between -1 and 1. 0 is default. Larger values will prioritize more similar companies, smaller values will prioritize more established companies.

minScorenumber double nullable

The minimum similarity score required for results. Must be between 0 and 1. When omitted, the default cutoff is used.

querystring nullable

The search query to apply on the company name and domain

categoryOperatorunknown
keywordsOperatorunknown
technologiesOperatorunknown
requireFeatureRequirement[] nullable

The features that must exist for the company

regionsstring[] nullable

The region IDs to filter by

countriesstring[] nullable

The 2 letter country codes to filter by

statesinteger[] nullable

The state IDs to filter by

citiesinteger[] nullable

The city IDs to filter by

typeCompanyType[] nullable

The list of company types to filter by

categoryCompanyCategory[] nullable

The list of company categories to filter by

employeesCompanyEmployees[] nullable

The list of employee counts to filter by

reportedEmployeesCompanyEmployees[] nullable

The list of externally reported employee counts to filter by

revenueCompanyRevenue[] nullable

The list of revenue ranges to filter by

naicsCodeinteger[] nullable

The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included

keywordsstring[] nullable

The keywords to filter by

technologiesstring[] nullable

The technologies to filter by

fundingRoundsCompanyFundingRound[] nullable

The funding rounds to filter by

Response

OK

pageinteger

The current page number. 1-indexed

totalPagesinteger

The total number of pages

totalItemsinteger

The total number of items in the list

Changes