Company Lookalikes
Returns company lookalikes based on seed companies.
Endpoint: (POST) https://api.lusha.com/v3/lookalike/companies
How It Works
First Request (Start a New Run):
- Do not send
dedupeSessionId - Server generates one and returns it in the response
- Use returned
dedupeSessionIdfor subsequent “get more” requests
Subsequent Requests (“Get More”):
- Send the returned
dedupeSessionIdto fetch more results without duplicates - Server uses
dedupeSessionIdto deduplicate companies already returned - Session history retained for 30 days from last activity (sliding window)
curl --request POST \
--url https://api.lusha.com/v3/lookalike/companies \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"domains": [
"sap.com",
"oracle.com",
"the-company.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google",
"https://www.linkedin.com/company/someone"
]
},
"exclude": {
"domains": [
"existingcustomer.com",
"already-sent.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/already-sent/"
]
},
"limit": 100
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"domain": "marriott.com",
"linkedinUrl": "https://www.linkedin.com/company/marriott-international",
"name": "Marriott International",
"employeeCount": 255334,
"industry": "Hospitality",
"location": {
"country": "United States",
"state": "Maryland",
"city": "Bethesda"
}
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"creditsCharged": 3
}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
Identifier batch for company inputs. Provide at least one of domains/linkedinUrls. For seeds: total unique identifiers across both arrays must be 5-100.
Show child attributes
Show child attributes
Dedupe session identifier. Omit on the first request to start a new run (server generates one). Provide on subsequent requests to get more results without duplicates.
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Identifier batch for company inputs. Provide at least one of domains/linkedinUrls. For seeds: total unique identifiers across both arrays must be 5-100.
Show child attributes
Show child attributes
Number of results to return per call (1-100)
1 <= x <= 10025
Response
Successfully retrieved company lookalikes
Server-generated session id to use for subsequent "get more" requests
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Lookalike companies
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Number of credits charged for this request
x >= 03
Was this page helpful?
curl --request POST \
--url https://api.lusha.com/v3/lookalike/companies \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"domains": [
"sap.com",
"oracle.com",
"the-company.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google",
"https://www.linkedin.com/company/someone"
]
},
"exclude": {
"domains": [
"existingcustomer.com",
"already-sent.com"
],
"linkedinUrls": [
"https://www.linkedin.com/company/already-sent/"
]
},
"limit": 100
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"domain": "marriott.com",
"linkedinUrl": "https://www.linkedin.com/company/marriott-international",
"name": "Marriott International",
"employeeCount": 255334,
"industry": "Hospitality",
"location": {
"country": "United States",
"state": "Maryland",
"city": "Bethesda"
}
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"creditsCharged": 3
}