Beam background
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

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.

julien

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.

Besoin d'aide ?
Envoyez nous un message dans la chatbox. Un développeur vous répondra dès que possible pour répondre à vos questions.
Pas un développeur ?
Nous pouvons vous aider à intégrer notre API. Envoyez-nous un message dans la chatbox.
https://api.thecompaniesapi.com

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.

nada

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).

ou

En envoyant le jeton API en tant que paramètre "GET". Comme ceci "?token=MY-API-TOKEN" (principalement utilisé pour tester rapidement un endpoint).

power

Veuillez noter que vous ne pouvez utiliser que HTTPS pour accéder à l'API. HTTP n'est pas pris en charge.

Pour vous aider à tester tous nos endpoints en un clic, votre jeton d'API est inclus dans tous les endpoints ci-dessous lorsque vous les copiez.
Créer un nouveau Token API
magic
Vous n'avez pas encore de token API
Créez un token API pour commencer à utiliser notre API.

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.

anthony

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

error. codestring
Pour certaines erreurs qui peuvent être gérées de manière programmable, un chiffre indiquant le code d'erreur rapporté.
403
error. messagestring
Un message lisible par un humain fournissant plus de détails sur l'erreur.
Missing api token
error. typeenum
Le type d'erreur retourné (voir la liste à votre droite).
apiConnectionError
Valeurs possibles
apiConnectionError
apiError
authenticationError
invalidRequestError
noCreditsRemaining
rateLimitError
200 - OKLa requête a réussi.
400 - Bad RequestLa requête est refusée, souvent en raison de l'absence d'un paramètre requis.
401 - UnauthorizedAucun jeton API valide fourni.
402 - Request FailedLes paramètres étaient valides, mais la requête a échoué.
403 - ForbiddenLe jeton API n'a pas la permission d'exécuter la requête.
404 - Not FoundLa ressource demandée n'existe pas.
409 - ConflictLa requête est en conflit avec une autre requête (peut-être en raison de l'utilisation de la même clé idempotente).
429 - Too Many RequestsTrop de requêtes ont frappé l'API trop rapidement. Nous vous recommandons une temporisation de vos requêtes.
500, 502, 503, 504 - Server ErrorsQuelque chose s'est mal passé de notre côté. Ces rares erreurs doivent être signalées, mais nous les enregistrons avec Sentry et les corrigeons dès qu'elles se produisent.
apiConnectionErrorÉchec de la connexion à The Companies API.
apiErrorLes erreurs API couvrent tout autre type de problème (par exemple, un problème temporaire avec les serveurs de The Companies API) et sont extrêmement rares.
authenticationErrorÉchec de l'authentification dans la requête.
invalidRequestErrorLes erreurs de requête invalides se produisent lorsque votre requête a des paramètres invalides.
noCreditsRemainingVous n'avez plus de crédits restants pour effectuer cette requête.
rateLimitErrorTrop de requêtes ont frappé l'API trop rapidement. Nous vous recommandons une temporisation de vos requêtes.

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.

julien

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.

Créer un nouveau webhook
magic
Vous n'avez pas encore de webhook
Créez un webhook pour recevoir une notification pour les événements que vous souhaitez suivre.

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.

power

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.

GET
https://api.thecompaniesapi.com/v1/companies
GET
https://api.thecompaniesapi.com/v1/companies/by-name
GET
https://api.thecompaniesapi.com/v1/companies/by-social
GET
https://api.thecompaniesapi.com/v1/companies/similar
GET
https://api.thecompaniesapi.com/v1/companies/:domain
GET
https://api.thecompaniesapi.com/v1/companies/:domain/email-patterns

Rechercher des entreprises par nom
1 Crédit

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.

julien

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

namerequis
Le nom de l'entreprise.
…/companies/by-name?name=amazon
countriesoptionnel
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
ad
ae
af
ag
ai
al
am
ao
aq
ar
as
at
au
aw
ax
az
ba
bb
bd
be
& 230 autres
exactWordsMatchoptionnel
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
sizeoptionnel
Le nombre d'entreprises à retourner (entre 1 et 25). Par défaut à 1.
…/companies/by-name?name=amazon&size=2
sortFieldoptionnel
Le champ pour trier les résultats. Par défaut à score.
…/companies/by-name?sortField=revenue
Valeurs possibles
monthlyVisitors
revenue
score
totalEmployees
yearFounded
sortOrderoptionnel
L'ordre pour trier les résultats. Par défaut à desc.
…/companies/by-name?sortOrder=asc
Valeurs possibles
asc
desc

Réponse

companiesarray
Les entreprises qui correspondent au nom.
metaobject
Les informations sur les métas.
GET
https://api.thecompaniesapi.com/v1/companies/by-name
Chargement de la réponse...

Enrichir une entreprise à partir d'un nom de domaine
1 Crédit

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.

power

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

domainrequis
Le nom de domaine de l'entreprise.
…/companies/gucci.com

Réponse

company. alexaRanknumber
Le classement Alexa de l'entreprise.
8
company. businessTypestring
Le type d'activité de l'entreprise.
public-company
Valeurs possibles
educational-institution
government-agency
nonprofit
partnership
privately-held
public-company
self-employed
sole-proprietorship
company. cityobject
La ville de l'entreprise.
company. codeNaicsstring
Le code SCIAN de l'entreprise.
518210
company. codeSicstring
Le code SIC de l'entreprise.
5961
company. companiesAcquisitionsarray
Les sociétés acquises.
company. companiesSubsidiariesarray
Les sociétés filiales.
company. companiesSimilararray
Les sociétés similaires.
company. companyParentobject
La société mère.
company. continentobject
Le continent de l'entreprise.
company. countryobject
Le pays de l'entreprise.
company. countyobject
Le département de l'entreprise.
company. descriptionstring
La description de l'entreprise.
Amazon.com, Inc. is an American multinational technology company based in Seattle, Washington, which focuses on…
company. descriptionShortstring
La description courte de l'entreprise en une ligne.
Amazon.com, Inc. is an American multinational technology company based in Seattle.
company. domainstring
Le domaine de l'entreprise.
amazon.com
company. domainAltsstring
Les domaines alternatifs de l'entreprise (redirection).
company. domainNamestring
Le nom de domaine de l'entreprise.
amazon
company. domainTldstring
Le domaine de premier niveau de l'entreprise.
com
company. emailPatternsarray
Les modèles d'e-mails de l'entreprise pour les employés.
company. idnumber
L'identifiant de l'entreprise.
5130216
company. industriesarray
Les secteurs d'activité de l'entreprise.
Internet, Fashion, Marketing…
company. industryMainstring
Le principal secteur d'activité de l'entreprise (généralement de LinkedIn).
Internet
company. logostring
URL du logo de l'entreprise.
https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/amazon.com.jpg
company. monthlyVisitorsenum
Nombre total de visiteurs mensuels de l'entreprise.
over-1b
Valeurs possibles
under-10k
10k-50k
50k-100k
100k-500k
500k-1m
1m-10m
10m-50m
50m-100m
100m-500m
500m-1b
over-1b
company. namestring
Le nom de l'entreprise.
Amazon
company. phoneNumberstring
Le numéro de téléphone de l'entreprise.
00 1 206-922-0880
company. revenueenum
Le chiffre d'affaires de l'entreprise.
over-1b
Valeurs possibles
under-1m
1m-10m
10m-50m
50m-100m
100m-200m
200m-1b
over-1b
company. socialNetworksobject
Les réseaux sociaux de l'entreprise.
company. stateobject
Région de l'entreprise.
company. stockExchangestring
La bourse de la société.
NYSE
company. stockSymbolstring
Le symbole boursier de la société.
AMZN
company. technologiesarray
Les technologies utilisées par l'entreprise.
company. technologyCategoriesarray
Les catégories de technologies utilisées par l'entreprise.
company. totalEmployeesenum
Le nombre total d'employés de l'entreprise.
over-10k
Valeurs possibles
1-10
10-50
50-200
200-500
500-1k
1k-5k
5k-10k
over-10k
company. totalEmployeesExactnumber
Le nombre exact d'employés de l'entreprise.
3930
company. yearFoundednumber
L'année de fondation de l'entreprise.
1994
GET
https://api.thecompaniesapi.com/v1/companies/gucci.com
Chargement de la réponse...

Compter les entreprises correspondant à votre filtre
Gratuit

Comptez les entreprises correspondant à votre filtre. Utile si vous construisez votre propre moteur de recherche d'entreprises.

queryrequis
Les conditions que les entreprises doivent remplir.
Assurez-vous que ce paramètre soir stringifié et encodé.
Industries
=
retail
Parcourir
Ajouter une condition
GET
https://api.thecompaniesapi.com/v1/companies/count?query=%5B%7B%22attribute%22%3A%22industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%5D%7D%5D
searchoptionnel
Une requête de recherche supplémentaire appliquée au nom de l'entreprise ou au domaine.
…/companies?search=amazon
searchFieldsoptionnel
Définissez les champs à rechercher.
…/companies?searchFields[]=domain&searchFields[]=name
Valeurs possibles
domain
name

Réponse

countnumber
Le nombre d'entreprises correspondant aux conditions.
GET
https://api.thecompaniesapi.com/v1/companies/count
Chargement de la réponse...

Trouver des entreprises similaires
0.25 Crédit

Envoyez-nous un ou plusieurs noms de domaine et nous vous retournerons une liste d'entreprises similaires.

julien

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

domainsrequis
Une liste de domaines séparés par des virgules.
…/companies/similar?domains[]=gucci.com&domains[]=wix.com
pageoptionnel
La page à récupérer (par défaut à 1).
…/companies/similar?domains[]=…&page=1
sizeoptionnel
Le nombre de sociétés similaires à retourner (entre 1 et 100). Par défaut à 10.
…/companies/similar?domains[]=…&size=50

Réponse

companiesarray
Les sociétés similaires pour votre liste de domaines.
metaobject
Les informations sur les métas.
GET
https://api.thecompaniesapi.com/v1/companies/similar?domains[]=gucci.com&page=1&size=10
Chargement de la 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.

power

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

domainrequis
Le domaine de l'entreprise.
…/companies/gucci.com/email-patterns

Réponse

patternsarray
Les modèles d'emails utilisés.
GET
https://api.thecompaniesapi.com/v1/companies/gucci.com/email-patterns
Chargement de la 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.

nada

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.

GET
https://api.thecompaniesapi.com/v1/employees
GET
https://api.thecompaniesapi.com/v1/employees/emails/discover
GET
https://api.thecompaniesapi.com/v1/employees/emails/enrich

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
false
true
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
false
true
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...

Découvrir l'email d'un employé
5 Crédits

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.

power

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

domainoptionnel
Le domaine de l'entreprise
…/emails/discover?domain=gucci.com
employeeIdoptionnel
L'identifiant de l'employé
…/emails/discover?employeId=123
Les crédits ne sont pas déduits avec ce paramètre.
firstNameoptionnel
Le prénom de l'employé
…/emails/discover?firstName=Jay
fullNameoptionnel
Le nom complet de l'employé
…/emails/discover?fullName=Jay%20Gatsby
lastNameoptionnel
Le nom de famille de l'employé
…/emails/discover?lastName=Gatsby
middleNameoptionnel
Le second prénom de l'employé
…/emails/discover?middle=James

Réponse

emailstring
L'email découvert.
emailDisposableboolean
Si l'email est jetable ou non.
false
emailDomainstring
Le domaine de l'email.
gucci.com
emailFreeboolean
Si l'email est gratuit ou non.
false
emailPatternstring
Le modèle de l'email.
[F].[L]
emailStatusstring
Le statut de l'email.
valid
Valeurs possibles
catch-all
error
guessed
identified
verified
verified-already
emailUsernamestring
Le nom d'utilisateur de l'email.
jay.gatsby
GET
https://api.thecompaniesapi.com/v1/employees/emails/discover
{email : "[email protected]" ,emailDisposable :false,emailDomain : "gucci.com" ,emailFree :false,emailPattern : "[F].[L]" ,emailStatus : "verified" ,emailUsername : "jay.gatsby" ,}

Enrichir un employé à partir de son email
1 Crédit

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).

julien

Si vous avez besoin d'un point de données spécifique, n'hésitez pas à nous le demander.

Paramètres de requête

emailrequis
L'email à enrichir.
…/employees/emails/[email protected]

Réponse

companyobject
Le profil de l'entreprise pour l'email.
emailstring
L'email envoyé à enrichir.
emailDisposableboolean
Si l'email est jetable ou non.
false
emailFreeboolean
Si l'email est gratuit ou non.
false
GET
https://api.thecompaniesapi.com/v1/employees/emails/enrich
Chargement de la réponse...

Industries

Recherchez des industries spécifiques et obtenez des informations telles que le nombre d'entreprises qu'elle contient.

anthony

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.

GET
https://api.thecompaniesapi.com/v1/industries
GET
https://api.thecompaniesapi.com/v1/industries/similar

Trouver des industries similaires
Gratuit

Découvrez des industries similaires avec notre API. Identifiez les secteurs connexes et élargissez vos opportunités commerciales.

Paramètres de requête

industriesrequis
Les industries à comparer (max: 10).
…/industries/similar?industries[]=saas&industries[]=fintech
pageoptionnel
La page à récupérer (par défaut 1).
…/industries/similar?page=1
sizeoptionnel
Le nombre d'industries à renvoyer (entre 1 et 100). Par défaut 25.
…/industries/similar?size=10

Réponse

industriesarray
Les industries qui correspondent à vos critères.
metaobject
Les informations sur les métas.
GET
https://api.thecompaniesapi.com/v1/industries/similar?industries[]=saas&size=10
Chargement de la 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.

power

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.

GET
https://api.thecompaniesapi.com/v1/job-titles/enrich

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.

nada

Notre base de données comprend plus de 165 000 professions réparties en 70 départements et 10 niveaux de responsabilité.

query

namerequis
Le nom de la profession.
…/job-titles/enrich?name=chief%20marketing%20officer

Réponse

jobTitle. departmentstring
Le service de la profession
marketing
Valeurs possibles
customer service
design
education
engineering
finance
health
human resources
legal
marketing
media
operations
public relations
real estate
sales
trades
jobTitle. departmentSecondarystring
Département secondaire de la profession
content marketing
Valeurs possibles
accounting
accounts
brand marketing
broadcasting
business development
compensation
content marketing
customer success
data
dental
devops
doctor
editorial
education administration
electrical
employee development
events
fitness
graphic design
information technology
& 35 autres
jobTitle. namestring
Le nom anglais de la profession
jobTitle. nameEsstring
Le nom espagnol de la profession
jobTitle. nameFrstring
Le nom français de la profession
jobTitle. seniorityLevelstring
Le niveau d'ancienneté de la profession
Valeurs possibles
owner
partner
cxo
vp
director
manager
senior
entry
training
unpaid
GET
https://api.thecompaniesapi.com/v1/job-titles/enrich
Chargement de la réponse...

Localisations

Les endpoints suivants vous permettent de rechercher toutes nos localisations: villes, départements, régions, pays et continents.

julien

Vous pouvez les utiliser pour filtrer nos entreprises ou cibler des employés dans une localisation spécifique.

GET
https://api.thecompaniesapi.com/v1/locations/cities
GET
https://api.thecompaniesapi.com/v1/locations/counties
GET
https://api.thecompaniesapi.com/v1/locations/states
GET
https://api.thecompaniesapi.com/v1/locations/countries
GET
https://api.thecompaniesapi.com/v1/locations/continents

Rechercher des villes
Gratuit

Recherchez nos villes pour filtrer les entreprises ou cibler des employés dans un lieu spécifique.

Paramètres de requête

pageoptionnel
La page à récupérer (par défaut 1).
…/locations/cities?page=1
searchoptionnel
Une recherche additionnelle appliquée au nom de la ville.
…/locations/cities?search=new%20york
sizeoptionnel
Le nombre de villes à retourner (entre 1 et 20). Par défaut 10.
…/locations/cities?size=20

Réponse

citiesarray
Les villes qui correspondent à vos conditions.
metaobject
Les informations sur les métas.
GET
https://api.thecompaniesapi.com/v1/locations/cities
Chargement de la 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.

Paramètres de requête

pageoptionnel
La page à récupérer (par défaut 1).
…/locations/counties?page=1
searchoptionnel
Une requête de recherche supplémentaire appliquée au nom du département.
…/locations/counties?search=newport
sizeoptionnel
Le nombre de départements à retourner (entre 1 et 20). Par défaut 10.
…/locations/counties?size=20

Réponse

countiesarray
Les départements qui correspondent à vos critères.
metaobject
Les informations sur les métas.
GET
https://api.thecompaniesapi.com/v1/locations/counties
Chargement de la réponse...

Rechercher des états
Gratuit

Rechercher nos régions pour filtrer nos entreprises ou cibler les employés dans un lieu spécifique.

Paramètres de requête

pageoptionnel
La page à récupérer (par défaut 1).
…/locations/states?page=1
searchoptionnel
Une recherche additionnelle appliquée au nom de la région.
…/locations/states?search=new%20york
sizeoptionnel
Le nombre d'états à retourner (entre 1 et 20). Par défaut 10.
…/locations/states?size=20

Réponse

statesarray
Les états qui correspondent à vos critères.