Prospecting
Prospecting Contacts
Search for contacts that match your Ideal Customer Profile using rich filter criteria.
Filter by contact attributes:
- Job title, seniority, department
- Location (city, state, country, continent)
- Existing data points (e.g. only contacts with a known work email)
- Signal activity (promotion, job change)
Filter by company attributes:
- Size, revenue, industry, technologies
- Location, intent topics, funding
Results are paginated up to 50,000 total (1,000 pages × 50 results). Use the returned contact id values with Enrich Contacts to reveal emails and phones.
Billing: Charged per result via api_search. If signals are requested, an additional charge applies per matched signal per result.
Persisting to a table: Pass tableId to also persist matching results into an existing table. This is additive — the primary response is unchanged, and a tableWrite object is added showing what happened on the table side. See Contacts Tables.
post/v3/contacts/prospecting
Request body
Example request
{
"pagination": {
"size": 25
},
"filters": {
"contacts": {
"include": {
"jobTitles": [
"VP Sales",
"Director of Sales"
],
"countries": [
"US",
"CA"
],
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"seniorityIds": [
4,
5
],
"departments": [
"Sales",
"Engineering"
],
"existingDataPoints": [
"work_email",
"work_phone"
],
"skills": [
"Python"
]
},
"exclude": {
"jobTitles": [
"VP Sales",
"Director of Sales"
],
"countries": [
"US",
"CA"
],
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"seniorityIds": [
4,
5
],
"departments": [
"Sales",
"Engineering"
],
"existingDataPoints": [
"work_email",
"work_phone"
],
"skills": [
"Python"
]
}
},
"companies": {
"include": {
"domains": [
"lusha.com"
],
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"sizes": [
{
"min": 50,
"max": 500
}
],
"revenues": [
{
"min": 1,
"max": 1000
}
],
"technologies": [
"Salesforce",
"HubSpot"
],
"technologiesCondition": "or",
"industriesLabels": [
"Software",
"SaaS"
],
"intentTopics": [
"Cloud Migration"
],
"topicCountThreshold": [
{
"min": 1,
"max": 1000
}
],
"foundedYear": [
{
"min": 2000,
"max": 2020
}
],
"businessModel": [
"B2B"
],
"companyType": [
"Public Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google"
],
"keywords": [
"fintech"
]
},
"exclude": {
"domains": [
"lusha.com"
],
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"sizes": [
{
"min": 50,
"max": 500
}
],
"revenues": [
{
"min": 1,
"max": 1000
}
],
"technologies": [
"Salesforce",
"HubSpot"
],
"technologiesCondition": "or",
"industriesLabels": [
"Software",
"SaaS"
],
"intentTopics": [
"Cloud Migration"
],
"topicCountThreshold": [
{
"min": 1,
"max": 1000
}
],
"foundedYear": [
{
"min": 2000,
"max": 2020
}
],
"businessModel": [
"B2B"
],
"companyType": [
"Public Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/google"
],
"keywords": [
"fintech"
]
}
}
},
"tableId": "482910"
}Response
Successful response
Example response
{
"results": [
{
"clientReferenceId": "my-ref-1",
"id": "4389064704",
"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"
},
"location": {
"country": "Israel",
"state": "Tel Aviv District",
"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
}
],
"signalTypes": [
"promotion",
"companyChange"
],
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"pagination": {
"size": 25
},
"tableWrite": {
"tableId": "482910",
"added": 3,
"alreadyPresent": 2,
"rowsProcessed": 5,
"rowsCharged": 5
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}