Prospecting
Prospecting Companies
Search for companies that match your target market using rich filter criteria.
Filter by:
- Size, revenue range, industry, sub-industry
- Technologies in use
- Locations (HQ country, state, city)
- SIC and NAICS codes
- Buyer intent topics
- Signal activity (headcount changes, hiring surges, news events, LinkedIn activity intent)
Use the returned company id values with Enrich Companies to get full firmographic data.
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 Companies Tables.
post/v3/companies/prospecting
Request body
Example request
{
"pagination": {
"size": 25
},
"filters": {
"companies": {
"include": {
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [
{
"min": 1,
"max": 1000
}
],
"topicCountThreshold": [
{
"min": 1,
"max": 1000
}
],
"signals": {
"types": [
"headcountIncrease3m",
"surgeInHiring",
"linkedinActivityIntent"
],
"filterByDepartment": [
{
"department": "Engineering & Technical"
}
],
"filterByIntentCategory": [
"Technology"
]
},
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": [
"B2B",
"B2G"
],
"companyType": [
"Public Company",
"Private Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/microsoft"
],
"keywords": [
"cloud",
"artificial intelligence"
]
},
"exclude": {
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
],
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [
{
"min": 1,
"max": 1000
}
],
"topicCountThreshold": [
{
"min": 1,
"max": 1000
}
],
"signals": {
"types": [
"headcountIncrease3m",
"surgeInHiring",
"linkedinActivityIntent"
],
"filterByDepartment": [
{
"department": "Engineering & Technical"
}
],
"filterByIntentCategory": [
"Technology"
]
},
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": [
"B2B",
"B2G"
],
"companyType": [
"Public Company",
"Private Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/microsoft"
],
"keywords": [
"cloud",
"artificial intelligence"
]
}
},
"contacts": {
"include": {
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
]
},
"exclude": {
"locations": [
{
"city": "San Francisco",
"state": "California",
"country": "United States",
"continent": "North America",
"countryGrouping": "EMEA",
"region": "California",
"countryIso2": "US"
}
]
}
}
},
"tableId": "583021"
}Response
Successful response
Example response
{
"results": [
{
"clientReferenceId": "comp-ref-1",
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com",
"employeeCount": {
"exact": 364,
"min": 201,
"max": 500
},
"industry": "Technology, Information & Media",
"location": {
"city": "London",
"state": "England",
"stateCode": "MA",
"country": "United Kingdom",
"countryIso2": "GB",
"continent": "Europe"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/lushadata"
},
"has": [
"alternativeName",
"alternativeDomains",
"description",
"companyType",
"yearFounded",
"subIndustry",
"specialities",
"sicCodes",
"naicsCodes",
"additionalLocations",
"linkedinFollowers",
"popularityTier",
"logoUrl",
"employeesByDepartment",
"employeesByLocation",
"employeesBySeniority",
"competitors",
"businessModel",
"phones",
"emails",
"keywords",
"socialLinks",
"estimatedAnnualItSpend",
"monthlyWebsiteTraffic"
],
"canReveal": [
{
"field": "employeesByDepartment",
"credits": 1
},
{
"field": "employeesByLocation",
"credits": 1
},
{
"field": "employeesBySeniority",
"credits": 1
},
{
"field": "competitors",
"credits": 1
},
{
"field": "intent",
"credits": 0
},
{
"field": "estimatedAnnualItSpend",
"credits": 1
},
{
"field": "monthlyWebsiteTraffic",
"credits": 1
}
],
"signalTypes": [
"headcountIncrease3m"
],
"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
}
}