Contact Lookalikes
Find contacts similar to a set of seed contacts using AI-powered recommendations.
Provide seed contacts via LinkedIn URLs, emails, Lusha IDs, or name + company. The API returns contacts who share similar roles, seniority, and company profiles.
Required: 5–100 seeds.
seedsmust contain at least 5 and at most 100 contacts in total, counted across all identifier types combined (linkedinUrls+emails+ids+contactIds+contacts). A request with fewer than 5 total seeds is rejected with400. Fewer than 5 seeds does not give the model enough signal to produce useful lookalikes.
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 contacts already seen. Sessions are retained for 30 days.
Use the exclude field to always filter out specific contacts (e.g. existing customers).
Results are lightweight previews. Use Enrich Contacts with the returned id to get emails and phones.
Billing: Charged per result via the
lookalikeContactaction.
Persisting to a table: Pass
tableIdto also persist matching results into an existing table. See Contacts Tables.
curl --request POST \
--url https://api.lusha.com/v3/contacts/lookalike \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"linkedinUrls": [
"https://www.linkedin.com/in/orit-shilvock-6243bb5",
"https://www.linkedin.com/in/shmulikwillinger"
],
"emails": [
"gal.ashkelon@lusha.com",
"miri.tamir@lusha.com"
],
"ids": [
"1234",
"4567"
]
},
"exclude": {
"emails": [
"existing@customer.com"
]
},
"limit": 25
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"id": "9659196",
"firstName": "Sarah",
"lastName": "Johnson"
}
],
"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 contacts in total, counted across all identifier types combined (linkedinUrls + emails + ids + contactIds + contacts). Fewer than 5 total seeds is rejected with 400. Cannot be null.
Show child attributes
Show child attributes
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Optional. Contacts to always filter out of the results (for example, existing customers). 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.
"482910"
Response
Successfully retrieved contact 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/contacts/lookalike \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"linkedinUrls": [
"https://www.linkedin.com/in/orit-shilvock-6243bb5",
"https://www.linkedin.com/in/shmulikwillinger"
],
"emails": [
"gal.ashkelon@lusha.com",
"miri.tamir@lusha.com"
],
"ids": [
"1234",
"4567"
]
},
"exclude": {
"emails": [
"existing@customer.com"
]
},
"limit": 25
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"id": "9659196",
"firstName": "Sarah",
"lastName": "Johnson"
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}