Rechercher des entreprises par nom
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.
Inscrivez-vous pour accéder à toutes les fonctionnalités de notre API
Recevez vos 500 crédits gratuits et commencez à enrichir et rechercher des entreprises.
Aucune carte de crédit requise
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
Les informations sur les métas.
import createClient from '@thecompaniesapi/sdk'
const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })
const response = await tca.searchCompaniesByName({
name: 'The Companies API',
size: 2
})
const companies = response.data.companies // Companies that match the name
const meta = response.data.meta // Meta information