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.
Bien sûr, si vous avez besoin d'aide pour quoique ce soit ou si vous souhaitez voir des fonctionnalités supplémentaires, n'hésitez pas à nous contacter dans la chatbox. Nous sommes généralement rapides pour les implémenter.
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.
Vos jetons d'API sont très importants, alors gardez-les en sécurité ! Ne les partagez pas dans des zones publiques telles que GitHub, le code côté client, etc. Ces clés d'authentification sont permanentes (elles n'expirent jamais). Vous pouvez les considérer comme sûrs à long terme.
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).
Veuillez noter que vous ne pouvez utiliser que HTTPS pour accéder à l'API. HTTP n'est pas pris en charge.
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.
Nous considérons le système de crédits comme un système de rate-limit par conception. Certaines fonctionnalités gratuites de l'API telles que les titres de poste, les industries et autres ont une sécurité de rate-limit. Contactez-nous avec votre cas d'utilisation si vous prévoyez de les utiliser à un volume élevé.
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.
Nous sommes toujours à la recherche de nouvelles façons d'utiliser les webhooks. Si vous avez la moindre suggestion, n'hésitez pas à nous contacter.
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.
Un concept important à garder à l'esprit est que nous représentons une entreprise par son nom de domaine (par exemple, gucci.com). C'est ce que nous utilisons comme clé unique. Cela signifie que lorsque nous découvrons un nouveau nom de domaine, nous le considérons comme une nouvelle entreprise.
Rechercher des entreprises0.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.
Pour vous aider à créer vos premières conditions, nous avons conçu un générateur ci-dessous. Nous serions également ravis de vous aider si vous en avez le besoin.
Paramètres de requête
Réponse
Rechercher des entreprises par nom1 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.
Si vous avez le nom de domaine d'une entreprise, il est préférable de l'utiliser. Nous l'utilisons comme clé unique dans notre base de données. Voir notre endpoint ci-dessous.
Paramètres de requête
Réponse
Enrichir une entreprise à partir d'un nom de domaine1 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.
Nous retournons plus de 50 points de données dont les industries, le chiffre d'affaires, les technologies… Si vous avez besoin de quelque chose que nous n'avons pas encore, n'hésitez pas à nous le faire savoir.
Paramètres de requête
Réponse
Compter les entreprises correspondant à votre filtreGratuit
Comptez les entreprises correspondant à votre filtre. Utile si vous construisez votre propre moteur de recherche d'entreprises.
Réponse
Trouver des entreprises similaires0.25 Crédit par entreprise similaire
Envoyez-nous un ou plusieurs noms de domaine et nous vous retournerons une liste d'entreprises similaires.
Cette fonctionnalité de l'API est l'une des plus puissantes. Vous pouvez l'utiliser pour trouver des entreprises similaires à la vôtre, ou pour trouver des entreprises similaires à vos clients. Vous pouvez également l'utiliser pour trouver des entreprises similaires à vos concurrents. Les possibilités sont infinies.
Paramètres de requête
Réponse
Trouver les formats d'emails pour un nom de domaine1 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.
Nous utilisons cette fonctionnalité en interne pour prioriser les modèles d'emails quand nous voulons deviner et vérifier une adresse email professionnelle avec des API externes. Vous pouvez utiliser cette API pour diminuer le nombre d'appels à des outils comme MailboxLayer ou Debounce (et donc vos coûts).
Paramètres de 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.
Si vous avez besoin de fonctionnalités supplémentaires, n'hésitez pas à nous contacter. Nous sommes généralement rapides pour les mettre en œuvre.
Identifier des employés en temps réel10 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.
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
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.
Nous ne déduisons pas de crédits lorsque vous fournissez l'identifiant de l'employé (employeeId) ou lorsque nous ne parvenons pas à déterminer l'adresse email.
Paramètres de requête
Réponse
Enrichir un employé à partir de son email1 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).
Si vous avez besoin d'un point de données spécifique, n'hésitez pas à nous le demander.
Paramètres de requête
Réponse
Industries
Recherchez des industries spécifiques et obtenez des informations telles que le nombre d'entreprises qu'elle contient.
Nous avons actuellement plus de 3 millions d'industries dans notre base de données. Nous pouvons vous envoyer un fichier avec nos 100 000 industries les plus populaires si vous souhaitez l'utiliser dans votre application.
Rechercher des industriesGratuit
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 "companies_count".
Paramètres de requête
Réponse
Trouver des industries similairesGratuit
Découvrez des industries similaires avec notre API. Identifiez les secteurs connexes et élargissez vos opportunités commerciales.
Paramètres de 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.
Si vous avez besoin de fonctionnalités supplémentaires, n'hésitez pas à nous contacter dans la chatbox. Nous sommes généralement rapides pour les implémenter.
Enrichir une profession à partir de son nomGratuit
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.
Notre base de données comprend plus de 165 000 professions réparties en 70 départements et 10 niveaux de responsabilité.
query
Réponse
Localisations
Les endpoints suivants vous permettent de rechercher toutes nos localisations: villes, départements, régions, pays et continents.
Vous pouvez les utiliser pour filtrer nos entreprises ou cibler des employés dans une localisation spécifique.
Rechercher des villesGratuit
Recherchez nos villes pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.
Paramètres de requête
Réponse
Rechercher des départementsGratuit
Rechercher des départements pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.
Paramètres de requête
Réponse
Rechercher des étatsGratuit
Rechercher nos régions pour filtrer nos entreprises ou cibler les employés dans un lieu spécifique.
Paramètres de requête
Réponse
Rechercher des paysGratuit
Rechercher des pays pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.
Paramètres de requête
Réponse
Rechercher des continentsGratuit
Rechercher des continents pour filtrer les entreprises ou cibler des employés dans un endroit spécifique.
Paramètres de requête
Réponse
Listes
Les entreprises et les employés peuvent être sauvegardés dans vos listes. Les endpoints suivants vous permettent de récupérer vos listes et de gérer les entreprises et les employés qui y sont associés.
Récupérer vos listesGratuit
Ce endpoint vous permet de récupérer les listes qui appartiennent à votre équipe.
Paramètres de requête
Réponse
Créer une liste d'entreprises ou d'employésGratuit
Ce point d'entrée vous permet de créer une liste d'entreprises ou d'employés.
Paramètres de requête
Réponse
Récupérer les entreprises de votre listeGratuit
Ce endpoint vous permet de récupérer les entreprises de vos listes.
Paramètres de requête
Réponse
Récupérer les employés de votre listeGratuit
Ce point d'entrée vous permet de récupérer les employés qui appartiennent à vos listes.