Skip to Content
CompanySpec
Recipes

Find lookalike companies

Start from your best customers and find more like them.

Pass up to 10 seed companies: examples of the kind of company you want, such as your best customers. We combine what they do and who they sell to, then return similar companies.

curl https://api.companyspec.com/v1/companies/similar \
  -H "Authorization: Bearer $COMPANYSPEC_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "companies": ["acmedental.io", "brightsmile-software.com"],
    "countries": ["US", "CA"],
    "exclude": { "domains": ["already-a-customer.com"] },
    "limit": 25
  }'
  • All search filters work on top of the seeds, except query and semantic_query: the seeds already describe what you're looking for.
  • Seeds are never returned in the results, and they aren't charged.
  • Results are sorted by match.score, their similarity to the seeds. min_score drops weaker ones.
  • similarity_weight (-1 to 1, default 0): at 1, only closeness to the seeds counts; at -1, larger, better-known companies are pushed up among the matches.
  • Returned companies cost 1 discovery each, once per billing month.
  • Seeds we can't find are ignored. If none are found, you get a 404.

Tip

Pick seeds that are similar to each other. Seeds from different markets give blended, weaker results; run one request per market instead.