Search
Search Contacts
Look up contacts by identifier. Returns a non-PII preview of each profile - no emails or phone numbers.
Accepted identifiers (one required per contact):
- Lusha contact
id linkedinUrlemailfirstName+lastName+companyNameorcompanyDomain
Up to 100 contacts per request. Each result includes:
has- data points available on this profilecanReveal- what you can unlock via Enrich Contacts, and the credit cost
Pass a signals filter to narrow results to contacts with recent activity (e.g. promotion, job change).
Billing: Charged per successful result via the
api_searchaction.
POST
/
v3
/
contacts
/
search
Search Contacts
curl --request POST \
--url https://api.lusha.com/v3/contacts/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"contacts": [
{
"clientReferenceId": "my-ref-1",
"firstName": "Orit",
"lastName": "Shilvock",
"companyName": "Lusha",
"companyDomain": "lusha.com"
},
{
"clientReferenceId": "my-ref-2",
"linkedinUrl": "https://www.linkedin.com/in/shmulikwillinger"
},
{
"clientReferenceId": "my-ref-3",
"email": "gal.ashkelon@lusha.com"
},
{
"clientReferenceId": "my-ref-4",
"id": "12345"
}
],
"options": {
"includePartialProfiles": true
}
}
'import requests
url = "https://api.lusha.com/v3/contacts/search"
payload = {
"contacts": [
{
"clientReferenceId": "my-ref-1",
"firstName": "Orit",
"lastName": "Shilvock",
"companyName": "Lusha",
"companyDomain": "lusha.com"
},
{
"clientReferenceId": "my-ref-2",
"linkedinUrl": "https://www.linkedin.com/in/shmulikwillinger"
},
{
"clientReferenceId": "my-ref-3",
"email": "gal.ashkelon@lusha.com"
},
{
"clientReferenceId": "my-ref-4",
"id": "12345"
}
],
"options": { "includePartialProfiles": True }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contacts: [
{
clientReferenceId: 'my-ref-1',
firstName: 'Orit',
lastName: 'Shilvock',
companyName: 'Lusha',
companyDomain: 'lusha.com'
},
{
clientReferenceId: 'my-ref-2',
linkedinUrl: 'https://www.linkedin.com/in/shmulikwillinger'
},
{clientReferenceId: 'my-ref-3', email: 'gal.ashkelon@lusha.com'},
{clientReferenceId: 'my-ref-4', id: '12345'}
],
options: {includePartialProfiles: true}
})
};
fetch('https://api.lusha.com/v3/contacts/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/contacts/search")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contacts\": [\n {\n \"clientReferenceId\": \"my-ref-1\",\n \"firstName\": \"Orit\",\n \"lastName\": \"Shilvock\",\n \"companyName\": \"Lusha\",\n \"companyDomain\": \"lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-2\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/shmulikwillinger\"\n },\n {\n \"clientReferenceId\": \"my-ref-3\",\n \"email\": \"gal.ashkelon@lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-4\",\n \"id\": \"12345\"\n }\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/search"
payload := strings.NewReader("{\n \"contacts\": [\n {\n \"clientReferenceId\": \"my-ref-1\",\n \"firstName\": \"Orit\",\n \"lastName\": \"Shilvock\",\n \"companyName\": \"Lusha\",\n \"companyDomain\": \"lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-2\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/shmulikwillinger\"\n },\n {\n \"clientReferenceId\": \"my-ref-3\",\n \"email\": \"gal.ashkelon@lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-4\",\n \"id\": \"12345\"\n }\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"requestId": "6e4b1192-9440-42c4-9a3e-793ddef6d73c",
"results": [
{
"clientReferenceId": "my-ref-1",
"id": "4415824633",
"firstName": "Orit",
"lastName": "Shilvock",
"jobTitle": {
"title": "Vice President of Partnerships",
"departments": [
"Business Development"
],
"seniority": "Vice President"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-2",
"id": "4415824679",
"firstName": "Shmulik",
"lastName": "Willinger",
"jobTitle": {
"title": "Chief Architect",
"departments": [
"Engineering & Technical"
],
"seniority": "C-Suite"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/shmulikwillinger"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-3",
"id": "4415824664",
"firstName": "Gal",
"lastName": "Ashkelon",
"jobTitle": {
"title": "Global Partner Program Manager",
"departments": [
"Business Development"
],
"seniority": "Manager"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/gal-ashkelon-39408557"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-4",
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"billing": {
"creditsCharged": 1,
"resultsReturned": 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
application/json
Was this page helpful?
⌘I
Search Contacts
curl --request POST \
--url https://api.lusha.com/v3/contacts/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"contacts": [
{
"clientReferenceId": "my-ref-1",
"firstName": "Orit",
"lastName": "Shilvock",
"companyName": "Lusha",
"companyDomain": "lusha.com"
},
{
"clientReferenceId": "my-ref-2",
"linkedinUrl": "https://www.linkedin.com/in/shmulikwillinger"
},
{
"clientReferenceId": "my-ref-3",
"email": "gal.ashkelon@lusha.com"
},
{
"clientReferenceId": "my-ref-4",
"id": "12345"
}
],
"options": {
"includePartialProfiles": true
}
}
'import requests
url = "https://api.lusha.com/v3/contacts/search"
payload = {
"contacts": [
{
"clientReferenceId": "my-ref-1",
"firstName": "Orit",
"lastName": "Shilvock",
"companyName": "Lusha",
"companyDomain": "lusha.com"
},
{
"clientReferenceId": "my-ref-2",
"linkedinUrl": "https://www.linkedin.com/in/shmulikwillinger"
},
{
"clientReferenceId": "my-ref-3",
"email": "gal.ashkelon@lusha.com"
},
{
"clientReferenceId": "my-ref-4",
"id": "12345"
}
],
"options": { "includePartialProfiles": True }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contacts: [
{
clientReferenceId: 'my-ref-1',
firstName: 'Orit',
lastName: 'Shilvock',
companyName: 'Lusha',
companyDomain: 'lusha.com'
},
{
clientReferenceId: 'my-ref-2',
linkedinUrl: 'https://www.linkedin.com/in/shmulikwillinger'
},
{clientReferenceId: 'my-ref-3', email: 'gal.ashkelon@lusha.com'},
{clientReferenceId: 'my-ref-4', id: '12345'}
],
options: {includePartialProfiles: true}
})
};
fetch('https://api.lusha.com/v3/contacts/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/contacts/search")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contacts\": [\n {\n \"clientReferenceId\": \"my-ref-1\",\n \"firstName\": \"Orit\",\n \"lastName\": \"Shilvock\",\n \"companyName\": \"Lusha\",\n \"companyDomain\": \"lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-2\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/shmulikwillinger\"\n },\n {\n \"clientReferenceId\": \"my-ref-3\",\n \"email\": \"gal.ashkelon@lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-4\",\n \"id\": \"12345\"\n }\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/search"
payload := strings.NewReader("{\n \"contacts\": [\n {\n \"clientReferenceId\": \"my-ref-1\",\n \"firstName\": \"Orit\",\n \"lastName\": \"Shilvock\",\n \"companyName\": \"Lusha\",\n \"companyDomain\": \"lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-2\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/shmulikwillinger\"\n },\n {\n \"clientReferenceId\": \"my-ref-3\",\n \"email\": \"gal.ashkelon@lusha.com\"\n },\n {\n \"clientReferenceId\": \"my-ref-4\",\n \"id\": \"12345\"\n }\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"requestId": "6e4b1192-9440-42c4-9a3e-793ddef6d73c",
"results": [
{
"clientReferenceId": "my-ref-1",
"id": "4415824633",
"firstName": "Orit",
"lastName": "Shilvock",
"jobTitle": {
"title": "Vice President of Partnerships",
"departments": [
"Business Development"
],
"seniority": "Vice President"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-2",
"id": "4415824679",
"firstName": "Shmulik",
"lastName": "Willinger",
"jobTitle": {
"title": "Chief Architect",
"departments": [
"Engineering & Technical"
],
"seniority": "C-Suite"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/shmulikwillinger"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-3",
"id": "4415824664",
"firstName": "Gal",
"lastName": "Ashkelon",
"jobTitle": {
"title": "Global Partner Program Manager",
"departments": [
"Business Development"
],
"seniority": "Manager"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"industry": "Technology, Information & Media"
},
"location": {
"country": "Israel",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/gal-ashkelon-39408557"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
]
},
{
"clientReferenceId": "my-ref-4",
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"billing": {
"creditsCharged": 1,
"resultsReturned": 3
}
}