Beam background
Company & Employee Enrichment API

Find Employees in Real-Time for a Company with our Enrichment API

Identify employees in real-time
10 credits

Search for employees with certain job titles inside a company. The company domain name is required, but job titles aren't. You can also use conditions the employees must match for more complicated queries (see query parameter).

You can also send the id of one of your lists to save the employees. If you don't have any list, you can create one with our endpoint to create a list.

Query

countries Optional
The country codes (comma-separated) to search for. If not defined, we will search for all countries. …/employees?countries=us,fr,de
Only countries with more than one million inhabitants are available.
Possible values ae af al am ao ar at au az ba bd be bf bg bh bi bj bo br bw Show more
domain Required
The company domain to search for employees (can also be a URL as we will extract the domain). …/employees?domain=gucci.com
findEmails Optional
If set to true, we will try to find the business email of the employees. This will make the response time slower. …/employees?findEmails=true
We advise people to avoid using this parameter as it can make the response time very slow. Instead, use our endpoint to discover emails when you receive the employees (free of charge).
Possible values true false
hideCompany Optional
If set to true, we will not attach the company information to the employees. This will make the response lighter. (default: false) …/employees?hideCompany=true
Possible values true false
jobTitles Optional
The job titles (comma-separated) to search for. If not defined, we will search for all job titles. …/employees?jobTitles=ceo,cto,software%20developer
listId Optional
The id of the list to save the employees to. …/employees?listId=102
page Optional
The page to fetch (default: 1). …/employees?page=1
You must request the first page before fetching the next ones. As employees are found in real-time, we cannot know how many pages there are.
query Optional
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
Make sure this parameter is stringified and encoded (i.e. encodeURIComponent).
job titles
=
Browse
Add a new condition
GET https://api.thecompaniesapi.com/v1/employees?query=%5B%7B%22attribute%22%3A%22jobTitles%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22marketing%22%5D%7D%5D&domain=gucci.com
size Optional
The number of employees to be returned (default to 100, max is 100). …/employees?size=10

Response

countries array
The country codes (comma-separated) to search for. If not defined, we will search for all countries.
employees array
The employees that match your conditions.
Show attributes
list object
The list the employees were saved to.
Show attributes
meta array
The metas information.
Show attributes
jobTitles array
The job titles (comma-separated) to search for. If not defined, we will search for all job titles.
query array
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
Show attributes
endpoint
GET https://api.thecompaniesapi.com/v1/employees
Response
Loading response...

Discover our other features to enrich your companies and identify employees in real-time

Companies
Employees
Industries
Job titles
Locations
Lists