Company & Employee Enrichment API
Find Employees in Real-Time for a Company with our Enrichment API
Identify employees in real-time
10 credits
per employee
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
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
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
query Optional
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
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
GET
https://api.thecompaniesapi.com/v1/employees
Loading response...
Discover our other features to enrich your companies and identify employees in real-time
6 endpoints
3 endpoints
1 endpoints
1 endpoints
5 endpoints
4 endpoints