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.

julien

You may wonder why our technology searches employees in real-time. From our experience (we were one of them), most services that rely on a database of employees take the risk of having outdated information. People leave from one job to another, get promoted, etc. This issue will never be one with us. The only downside is that it can take a few seconds to get the results.

Query parameters

countriesoptional
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
& 140 others
domainrequired
The company domain to search for employees (can also be a URL as we will extract the domain).
…/employees?domain=gucci.com
findEmailsoptional
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
hideCompanyoptional
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
jobTitlesoptional
The job titles (comma-separated) to search for. If not defined, we will search for all job titles.
…/employees?jobTitles=ceo,cto,software%20developer
listIdoptional
The id of the list to save the employees to.
…/employees?listId=102
pageoptional
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.
queryoptional
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.
Job titles
=
marketing
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
sizeoptional
The number of employees to be returned (default to 100, max is 100).
…/employees?size=10

Response

countriesarray
The country codes (comma-separated) to search for. If not defined, we will search for all countries.
employeesarray
The employees that match your conditions.
listobject
The list the employees were saved to.
metaobject
The metas information.
jobTitlesarray
The job titles (comma-separated) to search for. If not defined, we will search for all job titles.
queryarray
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
GET
https://api.thecompaniesapi.com/v1/employees
Loading response...
Company & Employee Enrichment API

Supercharge your product or your sales machine with our enrichment API for companies and employees

Companies
Employees
Industries
Job titles
Locations
Lists