Optimisez votre produit ou votre sales machine avec notre API d'enrichissement pour les entreprises et les employés
Documentation de l'API
The Companies API est organisée selon l'architecture REST. Nos routes acceptent des requêtes encodées au format form et retournent des réponses encodées au format JSON. Vous pouvez sauter d'une fonctionnalité à l'autre avec le menu de navigation à gauche. Des exemples avec des réponses réelles sont fournis sur le côté droit de la page.
Authentification
The Companies API utilise des jetons d'API pour authentifier les requêtes.
Vous pouvez gérer vos jetons d'API dans vos paramètres ou sur le côté droit de cette section.
Il y a deux façons d'authentifier vos requêtes HTTP vers l'API:
- En ajoutant un en-tête Autorization
. L'en-tête Authorization
est formaté comme suit : Authorization: Basic MY-API-TOKEN
(remplacez MY-API-TOKEN
par l'un des vôtres).
- En envoyant le jeton API en tant que paramètre GET
. Comme ceci ?token=MY-API-TOKEN
(principalement utilisé pour tester rapidement un endpoint).
Erreurs & Rate-Limiting
The Companies API utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec d'une requête API. En général, les codes dans la plage 2xx
indiquent un succès. Les codes dans la plage 4xx
indiquent une erreur qui a échoué compte tenu des informations fournies (par exemple, un paramètre requis a été omis). Les codes dans la plage 5xx
indiquent une erreur avec nos serveurs (ce sont des cas rares).
Certaines erreurs 4xx
qui peuvent être gérées de manière programmable comprennent un code d'erreur qui explique brièvement ce qu'il s'est produit.
Objet d'erreur
Webhooks
The Companies API utilise des webhooks pour vous notifier des changements ou lorsqu'une opération est terminée.
Vous pouvez gérer vos webhooks sur le côté droit de cette section ou dans vos paramètres.
Les webhooks sont utiles pour recevoir les résultats de nos algorithmes. Par exemple, lorsque une nouvelle entreprise que vous avez demandée a été scrappée ou quand nous avons trouvé un nouvel employé pour une de vos listes dynamiques.
Entreprises
Vous trouverez ci-dessous toutes nos fonctionnalités concernant notre base de données d'entreprises.
Vous pouvez rechercher des entreprises avec une condition spécifique ou par nom. Vous pouvez également récupérer le profil d'une entreprise en fournissant son nom de domaine ou l'une de ses URL de réseaux sociaux. Vous désirez également récupérer des entreprises similaires ou même les patterns d'e-mails qu'elles utilisent? Nous avons la solution.
Rechercher des entreprises
0.25 crédit
par entreprise
Vous avez besoin de rechercher des entreprises situées dans un pays donné pour un secteur d'activité spécifique et qui utilisent une technologie particulière ? Combinez nos conditions et créez des requêtes de recherche puissantes pour les identifier.
Requête
Réponse
Rechercher des entreprises par nom
1 crédit
par appel
Récupérez un profil d'entreprise en fournissant le nom de l'entreprise. Vous pouvez utiliser ce endpoint si vous avez besoin de plus d'informations sur l'entreprise, mais soyez prudent. Deux entreprises peuvent avoir le même nom, par exemple, Bolt. C'est pourquoi cette fonctionnalité peut retourner plusieurs entreprises.
Requête
Réponse
Enrichir une entreprise à partir d'un nom de domaine
1 crédit
par enrichissement
Enrichissez une entreprise en nous envoyant son nom de domaine. Le nom de domaine est un meilleur identifiant que le nom de l'entreprise car il est unique et moins sujet aux fautes de frappe.
Requête
Réponse
Trouver des entreprises similaires
0.25 crédit
par entreprise similaire
Envoyez-nous un ou plusieurs noms de domaine et nous vous retournerons une liste d'entreprises similaires.
Requête
Réponse
Trouver les formats d'emails pour un nom de domaine
1 crédit
Envoyez-nous un nom de domaine et récupérez tous les formats d'emails qu'ils utilisent avec le pourcentage d'utilisation.
Requête
Réponse
Employés
Nous concevons des algorithmes pour identifier les employés en temps réel ou les enrichir lorsque vous avez besoin de leur adresse e-mail ou de leurs informations de profil. Vous trouverez toutes nos fonctionnalités ci-dessous.
Identifier des employés en temps réel
10 crédits
par employé
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
Réponse
Découvrir l'email d'un employé
5 crédits
par email trouvé
Utilisez nos algorithmes pour trouver et vérifier l'email d'un employé. Envoyez-nous le prénom, le nom de famille, le second prénom et/ou l'identifiant de l'employé, et nous ferons le reste.
Requête
Réponse
Enrichir un employé à partir de son email
1 crédit
par enrichissement
Envoyez-nous un email professionnel, et nous l'enrichirons avec le profil de la société ainsi que des données sur l'employé (voir la liste ci-dessous).
Requête
Réponse
Industries
Recherchez des industries spécifiques et obtenez des informations telles que le nombre d'entreprises qu'elle contient.
Rechercher des industries Gratuit
Recherchez dans notre base de données d'industries et obtenez des informations telles que le nombre d'entreprises qu'elle contient. Les résultats sont triés par domains_count
.
Requête
Réponse
Professions
Vous trouverez toutes nos fonctionnalités concernant notre base de données de professions ci-dessous. Recherchez ou enrichissez des professions avec les départements et les niveaux de seniorité. Vous pouvez utiliser ces fonctionnalités pour apporter plus de contexte à vos clients dans votre CRM ou pour trouver des employés spécifiques avec nos algorithmes.
Enrichir une profession à partir de son nom Gratuit
Envoyez-nous une profession (par exemple, directeur général) et récupérez des informations supplémentaires telles que les départements et les niveaux de responsabilité. Nous supportons les langues suivantes: anglais, français et espagnol.
Requête
Réponse
Localisations
Les endpoints suivants vous permettent de rechercher toutes nos localisations: villes, départements, régions, pays et continents.
Rechercher des villes Gratuit
Recherchez nos villes pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.
Requête
Réponse
Rechercher des départements Gratuit
Rechercher des départements pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.
Requête
Réponse
Rechercher des états Gratuit
Rechercher nos régions pour filtrer nos entreprises ou cibler les employés dans un lieu spécifique.