Beam background
L'API d'enrichissement pour entreprises & employés

Rechercher des employés en temps réel avec notre API d'enrichissement

Identifier des employés en temps réel
10 crédits

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.

Requête

countries Optionnel
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 Afficher plus
domain Requis
Le nom de domaine de l'entreprise à rechercher (peut également être une URL car nous extrairons le domaine). …/employees?domain=gucci.com
findEmails Optionnel
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
hideCompany Optionnel
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
jobTitles Optionnel
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
listId Optionnel
L'identifiant de la liste pour enregistrer les employés. …/employees?listId=102
page Optionnel
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.
query Optionnel
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é (par exemple: encodeURIComponent).
Professions
=
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
size Optionnel
Le nombre d'employés à renvoyer (par défaut à 100, max à 100). …/employees?size=10

Réponse

countries array
Les codes de pays (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les pays.
employees array
Les employés qui correspondent à vos conditions.
Afficher les attributs
list object
La liste dans laquelle les employés ont été enregistrés.
Afficher les attributs
meta array
Les informations sur les métas.
Afficher les attributs
jobTitles array
Les intitulés de poste (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les intitulés de poste.
query array
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).
Afficher les attributs
endpoint
GET https://api.thecompaniesapi.com/v1/employees
Réponse
Chargement de la réponse...

Découvrez nos autres fonctionnalités pour enrichir vos entreprises et identifier les employés en temps réel

Entreprises
Employés
Industries
Professions
Localisations
Listes