Company Lookalikes
Find companies similar to a set of seed companies using AI-powered recommendations.
Provide seed companies via domains or LinkedIn URLs. The API returns companies with similar size, industry, and profile.
Required: 5–100 seeds.
seedsmust contain at least 5 and at most 100 companies in total, counted across all identifier types combined (domains+linkedinUrls). A request with fewer than 5 total seeds is rejected with400.
Pagination without duplicates:
On your first request, omit dedupeSessionId - the server generates one and returns it. Pass it on every subsequent request to get more results without repeating companies already seen. Sessions are retained for 30 days.
Use the exclude field to always filter out specific companies (e.g. existing customers or competitors).
Results are lightweight previews. Use Enrich Companies with the returned id to get full firmographic data.
Billing: Charged per result via the
lookalikeCompanyaction.
Persisting to a table: Pass
tableIdto also persist matching results into an existing table. See Companies Tables.
curl --request POST \
--url https://api.lusha.com/v3/companies/lookalike \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"domains": [
"sap.com",
"oracle.com",
"workday.com",
"servicenow.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google",
"https://www.linkedin.com/company/microsoft"
]
},
"exclude": {
"domains": [
"existingcustomer.com"
]
},
"limit": 100
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"id": "12345",
"name": "Marriott International",
"domain": "marriott.com"
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Body
Required. Minimum 5, maximum 100 seed companies in total, counted across all identifier types combined (domains + linkedinUrls). Fewer than 5 total seeds is rejected with 400.
Show child attributes
Show child attributes
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Optional. Companies to always filter out of the results (for example, existing customers or competitors). Omit the field entirely if you have nothing to exclude. Subject to the same 100-per-identifier-type cap as seeds, but has no minimum.
Show child attributes
Show child attributes
1 <= x <= 10025
Optional. If provided, results are also persisted to this table. See the Tables API.
"583021"
Response
Successfully retrieved company lookalikes
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.
Show child attributes
Show child attributes
Credit usage summary for a V3 API request
Show child attributes
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.lusha.com/v3/companies/lookalike \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"domains": [
"sap.com",
"oracle.com",
"workday.com",
"servicenow.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google",
"https://www.linkedin.com/company/microsoft"
]
},
"exclude": {
"domains": [
"existingcustomer.com"
]
},
"limit": 100
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"id": "12345",
"name": "Marriott International",
"domain": "marriott.com"
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}