Skip to main content
POST
Enrich Companies

Authorizations

api_key
string
header
required

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
ids
string[]
required

Company IDs from search results (strings)

Required array length: 1 - 100 elements
Example:
reveal
enum<string>[]

Additional data fields to reveal. Each field is charged separately per result.

  • employeesByDepartment - breakdown of employees by department
  • employeesByLocation - breakdown of employees by country/state
  • employeesBySeniority - breakdown of employees by seniority level
  • competitors - list of competitor company IDs
  • intent - buyer intent topics
  • estimatedAnnualItSpend - estimated annual IT spend.
  • monthlyWebsiteTraffic - monthly website traffic and month-over-month change.
  • openJobsTotal - reveals the total open job count. In the response, this appears as the total field inside the openJobs object.
  • openJobsByDepartment - reveals open job counts broken down by department. In the response, this appears as the byDepartment field inside the openJobs object.
  • openJobsByLocation - reveals open job counts broken down by location. In the response, this appears as the byLocation field inside the openJobs object.
  • openJobsBySeniority - reveals open job counts broken down by seniority level. In the response, this appears as the bySeniority field inside the openJobs object.
  • directParent - the company's immediate parent in its ownership tree.
  • ultimateParent - the company at the top of its ownership tree.
Available options:
employeesByDepartment,
employeesByLocation,
employeesBySeniority,
competitors,
intent,
estimatedAnnualItSpend,
monthlyWebsiteTraffic,
openJobsTotal,
openJobsByDepartment,
openJobsByLocation,
openJobsBySeniority,
directParent,
ultimateParent
Example:
tableId
string

Optional. If provided, these companies are also added to this table (if not already present) and the revealed fields' columns are populated. See the Tables API.

Example:

"583021"

Response

Successful response

requestId
string<uuid>
results
object[]
tableWrite
object

Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.

billing
object

Credit usage summary for a V3 API request