Similar Companies API examples

Each example on this page is one Similar Companies API request, shown in cURL, the four official SDKs, and the CLI. Every version sends the same request.

Before you start

Create an API key at app.companyenrich.com/access-keys. The SDK examples assume a client created like this, with the key in the COMPANYENRICH_API_KEY environment variable:

// npm install @companyenrich/sdk
import { CompanyEnrich } from '@companyenrich/sdk';

const client = new CompanyEnrich();

# pip install companyenrich
from companyenrich import CompanyEnrich

client = CompanyEnrich()

# gem install companyenrich
require "companyenrich"

client = CompanyEnrich::Client.new

<?php
// composer require companyenrich/sdk
require 'vendor/autoload.php';

use CompanyEnrich\Client;

$client = new Client();

npm install -g @companyenrich/cli
companyenrich auth login

In the cURL examples, replace YOUR_API_TOKEN with your key.

A lookalike search costs 5 credits for every company returned. To check a query for free first, see Count lookalikes for free.

Find companies similar to one company

Send one seed domain. The response lists similar companies in ranked order, with a score for each.

curl -X POST https://api.companyenrich.com/v2/companies/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookalike": {"domains": ["stripe.com"]},
    "pageSize": 25
  }'

const similar = await client.companies.search({
  lookalike: { domains: ['stripe.com'] },
  pageSize: 25,
});

for (const company of similar.items) {
  console.log(company.domain, similar.scores?.[company.id]);
}

similar = client.companies.search(
    lookalike={"domains": ["stripe.com"]},
    page_size=25,
)

scores = similar.get("scores") or {}
for company in similar["items"]:
    print(company["domain"], scores.get(company["id"]))

similar = client.companies.search(
  lookalike: { domains: ["stripe.com"] },
  page_size: 25
)

scores = similar["scores"] || {}
similar["items"].each do |company|
  puts "#{company['domain']} #{scores[company['id']]}"
end

$similar = $client->companies->search(
    lookalike: ['domains' => ['stripe.com']],
    pageSize: 25,
);

foreach ($similar['items'] as $company) {
    echo $company['domain'], ' ', $similar['scores'][$company['id']] ?? '', PHP_EOL;
}

companyenrich company similar stripe.com --limit 25

Scores are not probabilities. Keep the companies in the order returned.

Use several seeds and filter by market

Send up to 10 seeds to describe the kind of company you want, then narrow the lookalikes with filters. This search finds companies like Stripe and Adyen in the United States and Canada with 51 to 200 employees.

curl -X POST https://api.companyenrich.com/v2/companies/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookalike": {"domains": ["stripe.com", "adyen.com"]},
    "filter": {"country": ["US", "CA"], "employees": "51-200"},
    "pageSize": 25
  }'

const similar = await client.companies.search({
  lookalike: { domains: ['stripe.com', 'adyen.com'] },
  filter: { country: ['US', 'CA'], employees: '51-200' },
  pageSize: 25,
});

for (const company of similar.items) {
  console.log(company.domain, similar.scores?.[company.id]);
}

similar = client.companies.search(
    lookalike={"domains": ["stripe.com", "adyen.com"]},
    filter={"country": ["US", "CA"], "employees": "51-200"},
    page_size=25,
)

scores = similar.get("scores") or {}
for company in similar["items"]:
    print(company["domain"], scores.get(company["id"]))

similar = client.companies.search(
  lookalike: { domains: ["stripe.com", "adyen.com"] },
  filter: { country: ["US", "CA"], employees: "51-200" },
  page_size: 25
)

scores = similar["scores"] || {}
similar["items"].each do |company|
  puts "#{company['domain']} #{scores[company['id']]}"
end

$similar = $client->companies->search(
    lookalike: ['domains' => ['stripe.com', 'adyen.com']],
    filter: ['country' => ['US', 'CA'], 'employees' => '51-200'],
    pageSize: 25,
);

foreach ($similar['items'] as $company) {
    echo $company['domain'], ' ', $similar['scores'][$company['id']] ?? '', PHP_EOL;
}

companyenrich company similar stripe.com adyen.com --country US,CA --employees 51-200 --limit 25

Every company search filter works with a lookalike search.

Require a minimum similarity

Set minScore, from 0 to 1, to drop weaker matches.

curl -X POST https://api.companyenrich.com/v2/companies/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookalike": {"domains": ["notion.so"], "minScore": 0.7},
    "pageSize": 25
  }'

const similar = await client.companies.search({
  lookalike: { domains: ['notion.so'], minScore: 0.7 },
  pageSize: 25,
});

for (const company of similar.items) {
  console.log(company.domain, similar.scores?.[company.id]);
}

similar = client.companies.search(
    lookalike={"domains": ["notion.so"], "minScore": 0.7},
    page_size=25,
)

scores = similar.get("scores") or {}
for company in similar["items"]:
    print(company["domain"], scores.get(company["id"]))

similar = client.companies.search(
  lookalike: { domains: ["notion.so"], minScore: 0.7 },
  page_size: 25
)

scores = similar["scores"] || {}
similar["items"].each do |company|
  puts "#{company['domain']} #{scores[company['id']]}"
end

$similar = $client->companies->search(
    lookalike: ['domains' => ['notion.so'], 'minScore' => 0.7],
    pageSize: 25,
);

foreach ($similar['items'] as $company) {
    echo $company['domain'], ' ', $similar['scores'][$company['id']] ?? '', PHP_EOL;
}

companyenrich company similar notion.so --min-score 0.7 --limit 25

Exclude companies you already have

Use the domain filter with notIn to leave out companies you already work with.

curl -X POST https://api.companyenrich.com/v2/companies/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookalike": {"domains": ["stripe.com", "adyen.com"]},
    "filter": {"domain": {"notIn": ["checkout.com", "mollie.com"]}},
    "pageSize": 25
  }'

const similar = await client.companies.search({
  lookalike: { domains: ['stripe.com', 'adyen.com'] },
  filter: { domain: { notIn: ['checkout.com', 'mollie.com'] } },
  pageSize: 25,
});

for (const company of similar.items) {
  console.log(company.domain, similar.scores?.[company.id]);
}

similar = client.companies.search(
    lookalike={"domains": ["stripe.com", "adyen.com"]},
    filter={"domain": {"notIn": ["checkout.com", "mollie.com"]}},
    page_size=25,
)

scores = similar.get("scores") or {}
for company in similar["items"]:
    print(company["domain"], scores.get(company["id"]))

similar = client.companies.search(
  lookalike: { domains: ["stripe.com", "adyen.com"] },
  filter: { domain: { notIn: ["checkout.com", "mollie.com"] } },
  page_size: 25
)

scores = similar["scores"] || {}
similar["items"].each do |company|
  puts "#{company['domain']} #{scores[company['id']]}"
end

$similar = $client->companies->search(
    lookalike: ['domains' => ['stripe.com', 'adyen.com']],
    filter: ['domain' => ['notIn' => ['checkout.com', 'mollie.com']]],
    pageSize: 25,
);

foreach ($similar['items'] as $company) {
    echo $company['domain'], ' ', $similar['scores'][$company['id']] ?? '', PHP_EOL;
}

companyenrich company similar stripe.com adyen.com --exclude-domain checkout.com,mollie.com --limit 25

Count lookalikes for free

The count endpoint takes the same lookalike and filter fields as a search and costs nothing.

curl -X POST https://api.companyenrich.com/v2/companies/search/count \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lookalike": {"domains": ["stripe.com"]},
    "filter": {"country": "US"}
  }'

const { count, total } = await client.companies.count({
  lookalike: { domains: ['stripe.com'] },
  filter: { country: 'US' },
});
console.log(count, total);

result = client.companies.count(
    lookalike={"domains": ["stripe.com"]},
    filter={"country": "US"},
)
print(result["count"], result["total"])

result = client.companies.count(
  lookalike: { domains: ["stripe.com"] },
  filter: { country: "US" }
)
puts result["count"], result["total"]

$result = $client->companies->count(
    lookalike: ['domains' => ['stripe.com']],
    filter: ['country' => 'US'],
);
echo $result['count'], ' ', $result['total'], PHP_EOL;

companyenrich company count --similar-to stripe.com --country US

count is the number of companies your plan can access. For a lookalike query, total describes the pool of candidates the similarity search draws from.

Export lookalikes to CSV

An export runs the lookalike search in the background and stores the results as one file. It costs the same per company as the search itself. The CSV has a score column next to the company columns.

# 1. Start the export. The response includes the batch "id".
curl -X POST https://api.companyenrich.com/v2/companies/search/export \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 1000,
    "lookalike": {"domains": ["stripe.com"]},
    "filter": {"country": "US"}
  }'

# 2. Check the batch until "status" is "completed".
curl https://api.companyenrich.com/v2/batches/BATCH_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN"

# 3. Download the results as CSV.
curl "https://api.companyenrich.com/v2/companies/search/export/BATCH_ID/results?format=csv" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -o lookalikes.csv

import { writeFile } from 'node:fs/promises';

const job = await client.companies.searchExport.create({
  limit: 1000,
  lookalike: { domains: ['stripe.com'] },
  filter: { country: 'US' },
});

await client.batches.waitForCompletion(job.id);

const response = await client.companies.searchExport.csv(job.id);
await writeFile('lookalikes.csv', await response.text());

job = client.companies.search_export.create(
    1000,
    lookalike={"domains": ["stripe.com"]},
    filter={"country": "US"},
)

client.batches.wait_for_completion(job["id"])

with open("lookalikes.csv", "w", encoding="utf-8") as file:
    file.write(client.companies.search_export.csv(job["id"]))

job = client.companies.search_export.create(
  1000,
  lookalike: { domains: ["stripe.com"] },
  filter: { country: "US" }
)

client.batches.wait_for_completion(job["id"])

File.write("lookalikes.csv", client.companies.search_export.csv(job["id"]))

$job = $client->companies->searchExport->create(
    1000,
    lookalike: ['domains' => ['stripe.com']],
    filter: ['country' => 'US'],
);

$client->batches->waitForCompletion($job['id']);

file_put_contents('lookalikes.csv', $client->companies->searchExport->csv($job['id']));

companyenrich company export --similar-to stripe.com --country US --limit 1000 --wait -o lookalikes.csv

Find people at lookalike companies

To get people instead of companies, send the same seeds in company.lookalike on a people search. See Find people at companies like your customers.