Buscar empresas por nombre
Puedes usar este endpoint si necesitas más información sobre la empresa, pero ten cuidado.
Dos empresas pueden tener el mismo nombre, por ejemplo, Bolt.
Por eso, esta función puede devolver varias empresas.
Si tienes el nombre de dominio de una empresa, es mejor usarlo.
Lo usamos como clave única en nuestra base de datos.
Regístrate para acceder a todas las características de nuestra API
Obtén tus 500 créditos gratuitos y comienza a enriquecer y buscar empresas.
No se requiere tarjeta de crédito
El nombre de la empresa.
…/companies/by-name?name=microsoft
La página a recuperar (por defecto 1).
/companies/by-name?page=1
Los países para filtrar las empresas. Puedes proporcionar varios países separados por comas. Por defecto a todos los países.
/companies/by-name?countries=us,fr,de
Valores posibles
Si se establece en true, el nombre de la empresa debe coincidir con las palabras buscadas. 'Bank of A' no devolverá Bank of America, pero 'Bank of' y 'Bank of America' lo harán. Por defecto a true.
/companies/by-name?exactWordsMatch=false
IDs de tus listas separados por comas que contienen las empresas a excluir de los resultados.
/companies/by-name?listsToExclude=3920,3925
attributes.searchFields
/companies?searchFields[]=domain&searchFields[]=name
Valores posibles
Devuelve una versión simplificada de las empresas (no se deduce ningún crédito, pero se aplican limitaciones en el plan gratuito). Es útil para visualizar los datos antes de recuperar la versión completa. Por defecto a false.
/companies/by-name?simplified=true
Valores posibles
El número de empresas a devolver (entre 1 y 25). Por defecto a 1.
/companies/by-name?name=amazon&size=2
Un array de múltiples campos combinados para ordenar los resultados.
…/companies/by-name?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Asegúrate de que este parámetro esté convertido a cadena y codificado.
El campo para ordenar los resultados.
…/companies/by-name?sortKey=meta.score
Valores posibles
El orden para ordenar los resultados.
…/companies/by-name?sortOrder=asc
Valores posibles
La información de metadatos.
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