Contact Lookalikes
Returns contact lookalikes based on seed contacts.
Endpoint: (POST) https://api.lusha.com/v3/lookalike/contacts
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 dedupes against all contacts previously returned for the
dedupeSessionId - User-provided
exclude.*is applied on every request and combined with server-side dedupe - Session history retained for 30 days from last activity (sliding window)
curl --request POST \
--url https://api.lusha.com/v3/lookalike/contacts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"linkedinUrls": [
"https://www.linkedin.com/in/johndoe"
],
"emails": [
"jane@acme.com",
"bob@example.com"
],
"contacts": [
{
"firstName": "Alice",
"lastName": "Smith",
"companyDomain": "sap.com"
}
],
"contactIds": [
1234,
4567
]
},
"exclude": {
"emails": [
"existing@customer.com"
],
"linkedinUrls": [
"https://www.linkedin.com/in/already-contacted/"
],
"contactIds": [
9999
]
},
"limit": 25
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"contactId": "9659196",
"firstName": "Sarah",
"lastName": "Johnson",
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/sarahjohnson"
},
"company": {
"companyId": "8605368",
"name": "Marriott International",
"domain": "marriott.com"
},
"jobTitle": {
"title": "VP of Sales",
"departments": [
"Sales"
],
"seniority": "Director"
},
"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 contact inputs. Provide at least one of linkedinUrls, contacts, emails, or contactIds. For seeds: total unique identifiers across all arrays must be 5-100. For exclude: total must be at most 500.
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 contact inputs. Provide at least one of linkedinUrls, contacts, emails, or contactIds. For seeds: total unique identifiers across all arrays must be 5-100. For exclude: total must be at most 500.
Show child attributes
Show child attributes
Number of results to return per call (1-100)
1 <= x <= 10025
Response
Successfully retrieved contact lookalikes
Server-generated session id to use for subsequent "get more" requests. Null when no results on first request.
"58adaa77-7a6e-4c9b-8c2d-820a6538e613"
Lookalike contacts
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/contacts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"seeds": {
"linkedinUrls": [
"https://www.linkedin.com/in/johndoe"
],
"emails": [
"jane@acme.com",
"bob@example.com"
],
"contacts": [
{
"firstName": "Alice",
"lastName": "Smith",
"companyDomain": "sap.com"
}
],
"contactIds": [
1234,
4567
]
},
"exclude": {
"emails": [
"existing@customer.com"
],
"linkedinUrls": [
"https://www.linkedin.com/in/already-contacted/"
],
"contactIds": [
9999
]
},
"limit": 25
}
'{
"dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
"results": [
{
"contactId": "9659196",
"firstName": "Sarah",
"lastName": "Johnson",
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/sarahjohnson"
},
"company": {
"companyId": "8605368",
"name": "Marriott International",
"domain": "marriott.com"
},
"jobTitle": {
"title": "VP of Sales",
"departments": [
"Sales"
],
"seniority": "Director"
},
"location": {
"country": "United States",
"state": "Maryland",
"city": "Bethesda"
}
}
],
"meta": {
"returned": 1,
"hasMore": true
},
"creditsCharged": 3
}