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.

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.

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