Votre API d'enrichissement pour booster votre produit et votre marketing
Recherchez des entreprises, enrichissez une liste de domaines et trouvez des entreprises similaires.
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.
Envoyez nous un message dans la chatbox. Un développeur vous répondra dès que possible pour répondre à vos questions.
Nous pouvons vous aider à intégrer notre API. Envoyez-nous un message dans la chatbox.
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).
Bon à savoir
Aucun token API trouvé
Créez un token API pour commencer à utiliser nos endpoints.
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
Pour certaines erreurs qui peuvent être gérées de manière programmable, un chiffre indiquant le code d'erreur rapporté.
403
Un message lisible par un humain fournissant plus de détails sur l'erreur.
Missing API token
Le type d'erreur retourné (voir la liste à votre droite).
apiConnectionError
Valeurs possibles
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.
Aucun webhook trouvé
Créez un webhook pour recevoir une notification pour les événements importants.
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.
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.
Vous voulez construire un moteur de recherche d'entreprises puissant sur votre application ? Nous avons écrit un guide pour vous aider à le faire.Paramètres de requête
Un array de conditions que les entreprises doivent remplir.
Assurez-vous que ce paramètre soir stringifié et encodé.
Une liste de domaines séparés par des virgules à exclure des résultats.
/companies?domainsToExclude=amazon.com,pearson.com
Une liste d'URLs LinkedIn séparées par des virgules à exclure des résultats.
/companies?linkedinToExclude=https://www.linkedin.com/company/amazon,https://www.linkedin.com/company/pearson
La page à récupérer (par défaut 1).
/companies?page=1
Une requête de recherche supplémentaire appliquée au nom de l'entreprise ou au domaine.
/companies?search=amazon
Définissez les champs à rechercher.
/companies?searchFields[]=domain&searchFields[]=name
Valeurs possibles
Retourne une version simplifiée des entreprises (aucun crédit déduit mais des limitations sont appliquées sur le plan gratuit). C'est utile pour prévisualiser les données avant de récupérer la version complète. Par défaut à false.
/companies?simplified=true
Valeurs possibles
Le nombre d'entreprises à retourner (entre 1 et 100). Par défaut 10.
/companies?size=10
Un array de plusieurs champs combinés pour trier les résultats.
…/companies?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Assurez-vous que ce paramètre soir stringifié et encodé.
Le champ pour trier les résultats.
…/companies?sortKey=meta.score
Valeurs possibles
L'ordre pour trier les résultats.
…/companies?sortOrder=asc
Valeurs possibles
Réponse
Les entreprises qui correspondent à vos conditions.
Parcourir tous les points de donnéesLes informations sur les métas.
Les conditions que les entreprises doivent remplir.
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.
Paramètres de requête
Le nom de l'entreprise.
…/companies/by-name?name=microsoft
La page à récupérer (par défaut 1).
/companies/by-name?page=1
Les pays pour filtrer les entreprises. Vous pouvez fournir plusieurs pays séparés par une virgule. Par défaut à tous les pays.
/companies/by-name?countries=us,fr,de
Valeurs possibles
Si défini à true, le nom de l'entreprise doit correspondre aux mots recherchés. 'Bank of A' ne retournera pas Bank of America mais 'Bank of' et 'Bank of America' le feront. Par défaut à true.
/companies/by-name?exactWordsMatch=false
Les identifiants séparés par des virgules de vos listes contenant les entreprises à exclure des résultats.
/companies/by-name?listsToExclude=3920,3925
attributes.searchFields
/companies?searchFields[]=domain&searchFields[]=name
Valeurs possibles
Retourne une version simplifiée des entreprises (aucun crédit déduit mais des limitations sont appliquées sur le plan gratuit). C'est utile pour prévisualiser les données avant de récupérer la version complète. Par défaut à false.
/companies/by-name?simplified=true
Valeurs possibles
Le nombre d'entreprises à retourner (entre 1 et 25). Par défaut à 1.
/companies/by-name?name=amazon&size=2
Un array de plusieurs champs combinés pour trier les résultats.
…/companies/by-name?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Assurez-vous que ce paramètre soir stringifié et encodé.
Le champ pour trier les résultats.
…/companies/by-name?sortKey=meta.score
Valeurs possibles
L'ordre pour trier les résultats.
…/companies/by-name?sortOrder=asc
Valeurs possibles
Réponse
Les informations sur les métas.
Décrivez les entreprises que vous recherchez, et notre modèle d'IA les trouvera pour vous. Vous pouvez ajuster le seuil de similarité pour améliorer la précision de vos résultats.
Paramètres de requête
Le prompt que notre modèle d'IA utilisera pour rechercher des entreprises.
…/companies/by-prompt?prompt=universities in the united states
Les identifiants séparés par des virgules de vos listes contenant les entreprises à exclure des résultats.
/companies/by-prompt?listsToExclude=3920,3925
La page à récupérer (par défaut 1).
/companies/by-prompt?page=1
Le seuil de similarité à utiliser pour la recherche (entre 0 et 1). Par défaut à 0.75.
/companies/by-prompt?similarity=0.75
S'il faut retourner une version simplifiée du profil de l'entreprise. Par défaut à false.
/companies/by-prompt?simplified=true
Le nombre d'entreprises à retourner (entre 1 et 25). Par défaut à 10.
/companies/by-prompt?size=10
Un array de plusieurs champs combinés pour trier les résultats.
…/companies/by-prompt?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Assurez-vous que ce paramètre soir stringifié et encodé.
Le champ pour trier les résultats.
…/companies/by-prompt?sortKey=meta.score
Valeurs possibles
L'ordre pour trier les résultats.
…/companies/by-prompt?sortOrder=asc
Valeurs possibles
Réponse
La liste des entreprises correspondant à votre prompt.
Parcourir tous les points de donnéesLes informations sur les métas.
Envoyez-nous un ou plusieurs noms de domaine et nous vous retournerons une liste d'entreprises similaires.
Paramètres de requête
Une liste de domaines séparés par des virgules.
…/companies/similar?domains[]=microsoft.com&domains[]=wix.com
La page à récupérer (par défaut à 1).
/companies/similar?domains[]=…&page=1
Retourne une version simplifiée des entreprises (sans déduction de crédits mais des limitations sont appliquées sur le plan gratuit). Il est utile pour visualiser les données avant de récupérer la version complète. Par défaut à false.
/companies/similar?domains[]=…&simplified=true
Valeurs possibles
Le nombre de sociétés similaires à retourner (entre 1 et 100). Par défaut à 10.
/companies/similar?domains[]=…&size=50
Un array de plusieurs champs combinés pour trier les résultats.
…/companies/similar?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Assurez-vous que ce paramètre soir stringifié et encodé.
Le champ pour trier les résultats.
…/companies/similar?sortKey=meta.score
Valeurs possibles
L'ordre pour trier les résultats.
…/companies/similar?sortOrder=asc
Valeurs possibles
Réponse
Les sociétés similaires pour votre liste de domaines.
Parcourir tous les points de donnéesLes informations sur les métas.
Comptez les entreprises correspondant à votre filtre. Utile si vous construisez votre propre moteur de recherche d'entreprises.
Paramètres de requête
Un array de conditions que les entreprises doivent remplir.
Assurez-vous que ce paramètre soir stringifié et encodé.
Une requête de recherche supplémentaire appliquée au nom de l'entreprise ou au domaine.
/companies/count?search=amazon
Définissez les champs à rechercher.
/companies/count?searchFields[]=domain&searchFields[]=name
Valeurs possibles
Réponse
Le nombre d'entreprises correspondant aux conditions.
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.
Paramètres de requête
Le nom de domaine de l'entreprise (par exemple : apple.com, microsoft.com).
microsoft.com
Lorsqu'il est activé (true), renvoie une version simplifiée des données de l'entreprise. L'appel est gratuit et aucun crédit ne sera déduit.
/companies/microsoft.com?simplified=true
Lorsqu'il est activé (true), déclenche une mise à jour en temps réel des données de l'entreprise, incluant l'exploration du site web, l'analyse des réseaux sociaux et l'enrichissement via l'IA. Remarque : cette opération coûte 10 crédits supplémentaires par requête.
/companies/microsoft.com?refresh=true
Réponse
Informations générales sur l'entreprise.
Données analytiques et performances du site web.
Informations sur les applications offertes par l'entreprise.
Ressources de l'entreprise, y compris les actifs numériques.
Codes de classification industrielle standard pour l'entreprise et autres codes d'identification.
Détails sur les entreprises liées telles que les acquisitions et les filiales.
Informations de contact, y compris les emails et les téléphones.
Contenu fourni par l'entreprise comme les blogs, les podcasts et plus.
Descriptions de l'entreprise et mots-clés associés convertis en anglais avec notre IA.
Détails concernant le nom de domaine de l'entreprise.
Données financières et informations sur les revenus de l'entreprise.
Emplacements géographiques et sièges sociaux de l'entreprise.
Informations méta sur l'entreprise.
Informations supplémentaires sur l'entreprise que nous n'avons pas pu catégoriser.
Liens et métriques des réseaux sociaux de l'entreprise.
Technologies utilisées par l'entreprise.
URLs liées à l'entreprise.
Enrichir une entreprise en envoyant un email.
Vous souhaitez enrichir vos utilisateurs lors de leur inscription avec des données d'entreprise précises ? Nous avons écrit un guide pour vous aider à le faire.Paramètres de requête
Lorsqu'il est activé (true), renvoie une version simplifiée des données de l'entreprise. L'appel est gratuit et aucun crédit ne sera déduit.
/companies/[email protected]&simplified=true
Lorsqu'il est activé (true), déclenche une mise à jour en temps réel des données de l'entreprise, incluant l'exploration du site web, l'analyse des réseaux sociaux et l'enrichissement via l'IA. Remarque : cette opération coûte 10 crédits supplémentaires par requête.
/companies/microsoft.com?refresh=true
Réponse
El perfil de la empresa desde nuestra base de datos.
Parcourir tous les points de donnéesInformación adicional sobre el email.
Récupérer le profil d'une entreprise en nous envoyant une URL de réseau social (voir la liste ci-dessous pour ceux que nous acceptons).
Paramètres de requête
L'URL Dribbble de l'entreprise.
/companies/by-social?dribbble=https://dribbble.com/microsoft
L'URL Facebook de l'entreprise.
/companies/by-social?facebook=https://www.facebook.com/microsoft
L'URL GitHub de l'entreprise.
/companies/by-social?github=https://github.com/microsoft
L'URL Instagram de l'entreprise.
/companies/by-social?instagram=https://www.instagram.com/microsoft
L'URL LinkedIn de l'entreprise. Nous gérons à la fois les URL alpha (/company/microsoft) et les identifiants numériques (/company/6585).
/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft
L'URL Pinterest de l'entreprise.
/companies/by-social?pinterest=https://www.pinterest.com/microsoft
L'URL Snapchat de l'entreprise.
/companies/by-social?snapchat=https://www.snapchat.com/add/microsoft
L'URL TikTok de l'entreprise.
/companies/by-social?tiktok=https://www.tiktok.com/@microsoft
L'URL Twitter de l'entreprise.
/companies/by-social?twitter=https://twitter.com/microsoft
L'URL Wellfound de l'entreprise.
/companies/by-social?wellfound=https://wellfound.com/company/microsoft
L'URL YouTube de l'entreprise.
/companies/by-social?youtube=https://www.youtube.com/@microsoft
Lorsqu'il est activé (true), déclenche une mise à jour en temps réel des données de l'entreprise, incluant l'exploration du site web, l'analyse des réseaux sociaux et l'enrichissement via l'IA. Remarque : cette opération coûte 10 crédits supplémentaires par requête.
/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft&refresh=true
Réponse
Informations générales sur l'entreprise.
Données analytiques et performances du site web.
Informations sur les applications offertes par l'entreprise.
Ressources de l'entreprise, y compris les actifs numériques.
Codes de classification industrielle standard pour l'entreprise et autres codes d'identification.
Détails sur les entreprises liées telles que les acquisitions et les filiales.
Informations de contact, y compris les emails et les téléphones.
Contenu fourni par l'entreprise comme les blogs, les podcasts et plus.
Descriptions de l'entreprise et mots-clés associés convertis en anglais avec notre IA.
Détails concernant le nom de domaine de l'entreprise.
Données financières et informations sur les revenus de l'entreprise.
Emplacements géographiques et sièges sociaux de l'entreprise.
Informations méta sur l'entreprise.
Informations supplémentaires sur l'entreprise que nous n'avons pas pu catégoriser.
Liens et métriques des réseaux sociaux de l'entreprise.
Technologies utilisées par l'entreprise.
URLs liées à l'entreprise.
Envoyez-nous un nom de domaine et récupérez tous les formats d'emails qu'ils utilisent avec le pourcentage d'utilisation.
Paramètres de requête
Le domaine de l'entreprise.
…/companies/microsoft.com/email-patterns
Réponse
Les modèles d'emails utilisés.
Poser des questions sur une entreprise en utilisant notre modèle IA. Vous pouvez spécifier le modèle à utiliser (petit ou grand) et, optionnellement, fournir des champs pour structurer la réponse. Le modèle grand est plus cher mais fournit des réponses plus détaillées.
Paramètres de requête
Le domaine de l'entreprise sur lequel vous souhaitez poser une question.
…/companies/microsoft.com/ask
La question à poser au modèle IA.
What products does this company offer?
Un tableau définissant la structure simplifiée pour la réponse.
Si non fourni, la structure sera générée automatiquement en fonction de votre question.
Les valeurs possibles pour chaque champ:
- `description`: Une description optionnelle du champ.
- `key`: Une chaîne de caractères, généralement en camelCase. (required)
string`, `array
[{"description":"The products that the company offers","key":"products","type":"array|string"}]
Le modèle à utiliser pour la question.
large
Valeurs possibles
Réponse
La réponse à la question en une forme structurée.
Les informations méta sur la réponse.
Ce endpoint vous permet de récupérer des insights générés par IA sur une entreprise. Notre modèle IA analyse le site web de l'entreprise et d'autres sources autorisées pour extraire et synthétiser les informations clés en un contexte complet. Cela inclut des détails sur leur modèle de business, leur marché cible, leurs avantages concurrentiels et d'autres stratégies qui peuvent ne pas être évidentes à partir de données de l'entreprise non traitées.
Paramètres de requête
Le domaine de l'entreprise pour laquelle vous souhaitez récupérer le contexte.
…/companies/microsoft.com/context
Réponse
Le contexte de l'entreprise.
Les informations méta sur la réponse.
Analysez et obtenez des informations sur les entreprises correspondant à vos critères spécifiés. Vous pouvez explorer divers attributs, notamment le type d'entreprise, l'industrie, le nombre d'employés et plus encore. Ce endpoint permet également l'exportation de données dans plusieurs formats.
Paramètres de requête
L'attribut d'analyse pour agréger les données. Détermine quelle colonne sera utilisée pour regrouper et analyser les entreprises.
Valeurs possibles
Un tableau de conditions pour filtrer les entreprises.
Assurez-vous que ce paramètre soir stringifié et encodé.
Filtrer les analyses pour des listes spécifiques.
Le nombre maximum d'entreprises à inclure dans l'analyse (entre 1 et 10,000). La valeur par défaut est 100.
Valeurs possibles
L'ordre de tri des résultats.
Valeurs possibles
Réponse
Tableau de métriques agrégées (nombres et pourcentages) pour chaque valeur de l'attribut spécifié.
Métadonnées supplémentaires sur les résultats.
Exportez des données d'analyse sur les entreprises dans différents formats. Vous pouvez choisir des attributs spécifiques à exporter ou obtenir une exportation complète de tous les attributs d'analyse. Le endpoint renvoie un téléchargement de fichier dans le format choisi.
Paramètres de requête
L'ID de l'action pour filtrer les analyses.
Un tableau d'attributs d'analyse à exporter. Requis si full n'est pas vrai.
Valeurs possibles
Le format du fichier exporté (par défaut json).
Valeurs possibles
Si tous les attributs d'analyse doivent être exportés.
Filtrer les analyses pour une liste spécifique.
Un tableau de conditions pour filtrer les entreprises.
Assurez-vous que ce paramètre soir stringifié et encodé.
Le nombre de résultats à retourner.
L'ordre de tri des résultats.
Valeurs possibles
Réponse
Un tableau de points de données d'analyse contenant des comptes et des pourcentages pour chaque valeur
Métadonnées supplémentaires sur les résultats.
Vous trouverez ci-dessous un aperçu complet des actions que vous pouvez effectuer avec les entreprises.
Ces actions sont particulièrement puissantes pour automatiser les processus au sein de votre produit en utilisant notre API.
Elles vous permettent non seulement d'enrichir les entreprises qui ne sont pas encore présentes dans notre base de données, mais aussi de réaliser un enrichissement plus détaillé sur celles qui y figurent déjà si nécessaire (comme l'extraction de produits pour un site e-commerce).
Cet endpoint vous permet de demander une action pour une seule entreprise, plusieurs entreprises ou une liste complète d'entreprises.
Body de la requête
Les domaines à traiter. Si vous envoyez plus de 100K domaines, la requête sera divisée en plusieurs actions.
["pearson.com","united.com"]
Indique si vous demandez une estimation de prix.
Valeurs possibles
Le type de tâche à effectuer.
Valeurs possibles
L'ID de la liste à traiter.
42
Réponse
Les actions déclenchées par la demande.
Indique si vous demandez une estimation de prix.
Cet endpoint vous permet de récupérer vos dernières demandes d'actions.
Paramètres de requête
Si l'on doit récupérer les détails complets de l'action.
false
Les IDs des actions à récupérer.
[1,2]
L'ID de la liste pour laquelle récupérer les actions.
1
La page à récupérer (par défaut 1).
1
Le nombre d'actions à retourner (entre 1 et 25). Par défaut à 10.
10
Le statut des actions à récupérer.
Valeurs possibles
Réponse
La liste des actions.
Les informations sur les métas.
Recherchez des industries spécifiques et obtenez des informations telles que le nombre d'entreprises qu'elle contient.
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
La page à récupérer (par défaut 1).
/industries?page=1
Une requête de recherche supplémentaire appliquée au nom de l'industrie.
/industries?search=saas
Le nombre d'industries à renvoyer (entre 1 et 100). Par défaut 25.
/industries?size=10
Réponse
Les industries qui correspondent à vos critères.
Les informations sur les métas.
Découvrez des industries similaires avec notre API. Identifiez les secteurs connexes et élargissez vos opportunités commerciales.
Paramètres de requête
Les industries à comparer (max: 10).
/industries/similar?industries[]=saas&industries[]=fintech
La page à récupérer (par défaut 1).
/industries/similar?page=1
Le nombre d'industries à renvoyer (entre 1 et 100). Par défaut 25.
/industries/similar?size=10
Réponse
Les industries qui correspondent à vos critères.
Les informations sur les métas.
Nous traquons actuellement 369 technologies. Si vous avez besoin d'une technologie qui n'est pas répertoriée, n'hésitez pas à discuter avec nous car il nous faut généralement moins de 48 heures pour l'ajouter.
Parcourez les technologies que nous identifions et obtenez des informations telles que le nombre d'entreprises l'utilisant.
Paramètres de requête
La page à récupérer (par défaut 1).
/technologies?page=1
Une requête de recherche supplémentaire appliquée au nom de la technologie.
/technologies?search=shopify
Le nombre de technologies à renvoyer (entre 1 et 100). Par défaut 25.
/technologies?size=10
Réponse
Les technologies que nous identifions qui correspondent à vos conditions.
Les informations sur les métas.
Les endpoints suivants vous permettent de rechercher toutes nos localisations: villes, départements, régions, pays et continents.
Recherchez nos villes pour filtrer les entreprises dans un lieu spécifique.
Paramètres de requête
La page à récupérer (par défaut 1).
Une recherche additionnelle appliquée au nom de la ville.
Le nombre de villes à retourner (entre 1 et 20). Par défaut 10.
Réponse
Les villes qui correspondent à vos conditions.
Les informations sur les métas.
Rechercher des départements pour filtrer les entreprises dans un lieu spécifique.
Paramètres de requête
La page à récupérer (par défaut 1).
Une requête de recherche supplémentaire appliquée au nom du département.
Le nombre de départements à retourner (entre 1 et 20). Par défaut 10.
Réponse
Les départements qui correspondent à vos critères.
Les informations sur les métas.
Rechercher nos régions pour filtrer nos entreprises dans un lieu spécifique.
Paramètres de requête
La page à récupérer (par défaut 1).
Une recherche additionnelle appliquée au nom de la région.
Le nombre d'états à retourner (entre 1 et 20). Par défaut 10.
Réponse
Les états qui correspondent à vos critères.
Les informations sur les métas.
Rechercher des pays pour filtrer les entreprises dans un lieu spécifique.
Paramètres de requête
La page à récupérer (par défaut 1).
Une recherche additionnelle appliquée au nom du pays.
Le nombre de pays à retourner (entre 1 et 20). Par défaut 10.
Réponse
Les pays qui correspondent à vos critères.
Les informations sur les métas.
Rechercher des continents pour filtrer les entreprises dans un endroit spécifique.
Paramètres de requête
La page à récupérer (par défaut 1).
Une recherche additionnelle appliquée au nom du continent.
Le nombre de continents à retourner (entre 1 et 20). Par défaut 10.
Réponse
Les continents qui correspondent à vos conditions.
Les informations sur les métas.
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 cibler des employés avec d'autres fournisseurs.
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.
Paramètres de requête
Le nom de la profession.
/job-titles/enrich?name=chief%20executive%20officer
Réponse
Le service de la profession
marketing
Valeurs possibles
Département secondaire de la profession
content marketing
Valeurs possibles
Le nom anglais de la profession
Le nom espagnol de la profession
Le nom français de la profession
Le niveau d'ancienneté de la profession
Valeurs possibles
Les entreprises peuvent être sauvegardés dans vos listes. Les endpoints suivants vous permettent de récupérer vos listes et de gérer les entreprises qui y sont associés.
Ce endpoint vous permet de récupérer les listes qui appartiennent à votre équipe.
Paramètres de requête
La page à récupérer (par défaut: 1).
/lists?page=1
Le nombre de listes à récupérer (entre 1 et 100). Par défaut à 10.
/lists?size=10
Réponse
Les listes qui appartiennent à votre équipe.
Les informations sur les métas.
Ce point d'entrée vous permet de créer une liste d'entreprises.
Body de la requête
Si la liste est dynamique ou non. Si défini à true, la liste sera mise à jour automatiquement lorsque de nouvelles entreprises seront ajoutés à la base de données.
Valeurs possibles
Le nom de la liste.
Le type de liste à créer.
Valeurs possibles
Réponse
L'analytics de la liste.
Quand la liste a été créée.
2022-02-22T07:23:52.000+00:00
Si la liste est dynamique ou statique.
true
L'identifiant de la liste.
3838
Si la liste a été importée.
true
Les intégrations associées à la liste.
Le nom de la liste
SaaS with 100k+ MRR
Le statut de processus actif de la liste (pour usage interne).
true
L'indicateur d'initialisation du processus (à usage interne).
true
Lorsque la liste est en cours de traitement.
2022-02-22T07:23:52.000+00:00
La requête utilisée pour générer la liste.
Ce endpoint vous permet de récupérer les entreprises de vos listes.
Paramètres de requête
La page à récupérer (par défaut 1).
/lists/:listId/companies?page=1
Le nombre d'entreprises à récupérer (entre 1 et 100). Par défaut 10.
/lists/:listId/companies?size=10
La requête pour filtrer les entreprises dans votre liste.
Assurez-vous que ce paramètre soir stringifié et encodé.
Un array de plusieurs champs combinés pour trier les résultats.
…/lists/:listId/companies?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Assurez-vous que ce paramètre soir stringifié et encodé.
Le champ pour trier les résultats.
…/lists/:listId/companies?sortKey=meta.score
Valeurs possibles
L'ordre pour trier les résultats.
…/lists/:listId/companies?sortOrder=asc
Valeurs possibles
Réponse
Les informations sur les métas.
Utilisez cet endpoint pour gérer les entreprises dans vos listes en les ajoutant (attaching) ou en les supprimant (detaching) en utilisant leurs domaines ou IDs. Vous pouvez modifier jusqu'à 1,000 entreprises par requête API.
Paramètres de requête
L'action à effectuer sur les entreprises: 'attach' pour les ajouter à la liste, ou 'detach' pour les supprimer de la liste.
Valeurs possibles
Un tableau de domaines d'entreprises (e.g. ['microsoft.com', 'apple.com']) à ajouter ou à supprimer de la liste. Maximum 1,000 domaines.
Un tableau de IDs de sociétés pour ajouter ou supprimer de la liste (chaque ID pour une société est disponible dans metas.mysqlId). Maximum 1,000 IDs de société.
Réponse
L'analytics de la liste.
Quand la liste a été créée.
2022-02-22T07:23:52.000+00:00
Si la liste est dynamique ou statique.
true
L'identifiant de la liste.
3838
Si la liste a été importée.
true
Les intégrations associées à la liste.
Le nom de la liste
SaaS with 100k+ MRR
Le statut de processus actif de la liste (pour usage interne).
true
L'indicateur d'initialisation du processus (à usage interne).
true
Lorsque la liste est en cours de traitement.
2022-02-22T07:23:52.000+00:00
La requête utilisée pour générer la liste.
Les endpoints suivants vous permettent de gérer et de récupérer des informations détaillées sur l'équipe associée à votre jeton API.
Cet endpoint vous permet de récupérer l'équipe associée à votre token API.
Réponse
Le pays de l'équipe.
us
La date de création de l'équipe.
2020-06-29 08:21:01
Les crédits de l'équipe.
500000
Si l'équipe est abonnée à un plan payant.
true
L'identifiant de l'équipe.
1
Le nom de l'équipe.
Jay Gatsby Enterprises
L'URL du site web de l'équipe.
https://www.jaygatsbyenterprises.com
Nos endpoints d'utilitaires fournissent des outils utiles et des informations sur notre API. Ceux-ci incluent la vérification de l'état de santé de l'API et la récupération de la spécification OpenAPI.
Vérifiez l'état de santé de notre API et de ses différents services.
Réponse
État de santé global de l'API.
Nom du nœud répondant à la requête.
Rapport de santé détaillé pour chaque service.
Récupérez la spécification OpenAPI de notre API, qui fournit une description détaillée de tous les endpoints disponibles, des paramètres de requête et des formats de réponse.
Réponse
Composants réutilisables utilisés dans toute la spécification de l'API.
Documentation externe supplémentaire.
Métadonnées sur l'API.
La version de la spécification OpenAPI.
Les chemins et opérations disponibles pour l'API.
Un tableau d'objets serveur, qui fournissent des informations de connectivité à un serveur cible.
Webhooks entrants qui peuvent être reçus dans le cadre de cette API.