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
queryandsemantic_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_scoredrops weaker ones. similarity_weight(-1to1, default0): at1, 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.