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)
Results are paginated up to 50,000 total. 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
}
}