Rechercher des employés avec certains intitulés de poste au sein d'une entreprise. Le nom de domaine de l'entreprise est requis, mais les intitulés de poste ne le sont pas. Vous pouvez également utiliser des conditions auxquelles les employés doivent correspondre pour des requêtes plus compliquées (voir paramètre query).

Vous pouvez également envoyer l'identifiant d'une de vos listes pour enregistrer les employés. Si vous n'avez pas de liste, vous pouvez en créer une avec notre endpoint pour créer une liste.

Vous vous demandez peut-être pourquoi notre technologie recherche les employés en temps réel. D'après notre expérience (nous en faisions partie), la plupart des services qui s'appuient sur une base de données d'employés prennent le risque d'avoir des informations obsolètes. Les gens quittent leur entreprise, sont promu, etc. Ce problème n'en sera jamais un avec nous. Le seul inconvénient est que cela peut prendre quelques secondes pour obtenir les résultats.

countriesoptionnel

Les codes de pays (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les pays.

…/employees?countries=us,fr,de

Seuls les pays avec plus d'un million d'habitants sont disponibles.

Valeurs possibles

ae

af

al

am

ao

ar

at

au

az

ba

bd

be

bf

bg

bh

bi

bj

bo

br

bw

& 140 autres

domainrequis

Le nom de domaine de l'entreprise à rechercher (peut également être une URL car nous extrairons le domaine).

…/employees?domain=gucci.com

findEmailsoptionnel

Si défini sur true, nous essaierons de trouver l'email professionnel des employés. Cela ralentira le temps de réponse.

…/employees?findEmails=true

Nous conseillons aux utilisateurs d'éviter d'utiliser ce paramètre car il peut rendre le temps de réponse très long. À la place, utilisez notre endpoint pour découvrir les emails des employés lorsque vous recevez les résultats (gratuitement).

Valeurs possibles

true

false

hideCompanyoptionnel

Si défini sur true, nous n'ajouterons pas les informations de l'entreprise aux employés. Cela rendra la réponse plus légère. (par défaut: false)

…/employees?hideCompany=true

Valeurs possibles

true

false

jobTitlesoptionnel

Les intitulés de poste (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les intitulés de poste.

…/employees?jobTitles=ceo,cto,software%20developer

listIdoptionnel

L'identifiant de la liste pour enregistrer les employés.

…/employees?listId=102

pageoptionnel

La page à récupérer (par défaut: 1).

…/employees?page=1

Vous devez demander la première page avant de demander les suivantes. Comme les employés sont trouvés en temps réel, nous ne pouvons pas savoir combien de pages il y a.

queryoptionnel

Une liste plus complexe de conditions auxquelles les employés doivent correspondre (si vous souhaitez quelque chose de plus précis que le paramètre jobTitles ou countries).

Assurez-vous que ce paramètre soir stringifié et encodé.

Professions

=

Marketing

Parcourir

Ajouter une 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

sizeoptionnel

Le nombre d'employés à renvoyer (par défaut à 100, max à 100).

…/employees?size=10