Search Contact Signals
Search for contact signals using identifiers like LinkedIn URL, email, or name + company. This endpoint combines search and signal enrichment in a single request.
Endpoint: (POST) https://api.lusha.com/api/signals/contacts/search
Search Requirements: Each contact can be identified by:
- Contact ID
- LinkedIn URL
- Email address
- Full name + Company (name or domain)
Default Behavior:
- Returns signals from the last 6 months by default
- Contacts are matched based on provided identifiers
- Returns both contact data and associated signals
curl --request POST \
--url https://api.lusha.com/api/signals/contacts/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"contacts": [
{
"id": "123321",
"social_link": "https://www.linkedin.com/in/ron-nabet"
}
],
"signals": [
"promotion",
"companyChange"
],
"startDate": "2025-01-01",
"maxResultsPerSignal": 5
}
'{
"contacts": {
"123321": {
"personId": "115889",
"companyChange": [
{
"personId": "115889",
"currentCompanyId": 8217,
"currentCompanyName": "Callaway Golf",
"currentDepartments": "R&D",
"currentSeniorityLabel": "c-suite",
"currentTitle": "Senior Manager, IT Solutions",
"signalDate": "2025-05-01",
"previousCompanyName": "Previous Corp",
"previousDomain": "nextgen.com",
"currentDomain": "vendavo.com"
}
],
"promotion": [
{
"personId": "115889",
"currentCompanyId": 8217,
"currentCompanyName": "Callaway Golf",
"currentDepartments": "R&D",
"currentSeniorityLabel": "c-suite",
"currentTitle": "Senior Manager, IT Solutions",
"signalDate": "2025-05-01",
"previousCompanyName": "Previous Corp",
"previousDomain": "nextgen.com",
"currentDomain": "vendavo.com"
}
]
}
},
"endDate": "2025-07-31",
"startDate": "2025-01-01",
"creditCharged": 2
}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
List of contact identifiers to search for
Show child attributes
Show child attributes
Types of signals to retrieve
allSignals, promotion, companyChange ["promotion", "companyChange"]
Start date for signal retrieval (YYYY-MM-DD format)
"2025-01-01"
Maximum number of signal instances to return per signal type per entity. Optional.
Default behavior when omitted:
- No
startDateprovided: all available signals are returned startDateprovided: all signals from that date onward are returned
10
Response
Contact signals search results
Was this page helpful?
curl --request POST \
--url https://api.lusha.com/api/signals/contacts/search \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"contacts": [
{
"id": "123321",
"social_link": "https://www.linkedin.com/in/ron-nabet"
}
],
"signals": [
"promotion",
"companyChange"
],
"startDate": "2025-01-01",
"maxResultsPerSignal": 5
}
'{
"contacts": {
"123321": {
"personId": "115889",
"companyChange": [
{
"personId": "115889",
"currentCompanyId": 8217,
"currentCompanyName": "Callaway Golf",
"currentDepartments": "R&D",
"currentSeniorityLabel": "c-suite",
"currentTitle": "Senior Manager, IT Solutions",
"signalDate": "2025-05-01",
"previousCompanyName": "Previous Corp",
"previousDomain": "nextgen.com",
"currentDomain": "vendavo.com"
}
],
"promotion": [
{
"personId": "115889",
"currentCompanyId": 8217,
"currentCompanyName": "Callaway Golf",
"currentDepartments": "R&D",
"currentSeniorityLabel": "c-suite",
"currentTitle": "Senior Manager, IT Solutions",
"signalDate": "2025-05-01",
"previousCompanyName": "Previous Corp",
"previousDomain": "nextgen.com",
"currentDomain": "vendavo.com"
}
]
}
},
"endDate": "2025-07-31",
"startDate": "2025-01-01",
"creditCharged": 2
}