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.

julien

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.

Paramètres de requête

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

Réponse

countriesarray
Les codes de pays (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les pays.
employeesarray
Les employés qui correspondent à vos conditions.
listobject
La liste dans laquelle les employés ont été enregistrés.
metaobject
Les informations sur les métas.
jobTitlesarray
Les intitulés de poste (séparés par des virgules) à rechercher. Si non défini, nous rechercherons tous les intitulés de poste.
queryarray
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).
GET
https://api.thecompaniesapi.com/v1/employees
Chargement de la réponse...
L'API d'enrichissement pour entreprises & employés

Optimisez votre produit ou votre sales machine avec notre API d'enrichissement pour les entreprises et les employés

Entreprises
Employés
Industries
Professions
Localisations
Listes