The Companies API LogoThe Companies API Logo
APIEmpresasCasos de usoPrecios
Iniciar sesiónIniciar sesión

Tu API de enriquecimiento para impulsar tu producto y tu marketing

Busca empresas, enriquece una lista de dominios y encuentra negocios similares.

Buscar o enriquecer empresasEmpresas
13 Puntos finales
Solicitar acciones en empresasAccionesNuevo
2 Puntos finales
Explorar nuestras industriasIndustrias
2 Puntos finales
Explorar nuestras tecnologíasTecnologías
1 Punto final
Explorar nuestras ubicacionesUbicaciones
5 Puntos finales
Explorar nuestros títulos de trabajoTítulos de trabajo
1 Punto final
Gestionar tus listasListas
4 Puntos finales
Gestionar tu equipoEquipo
1 Punto final
Utilidades de la APIUtilidades
2 Puntos finales

Documentación de la API

La API de Empresas está construida utilizando la arquitectura REST. Nuestras rutas aceptan cuerpos de solicitud codificados en formato de formulario y devuelven respuestas codificadas en formato JSON. Puede pasar de una función a otra con el menú de navegación a su izquierda. Se proporcionan ejemplos con respuestas reales en el lado derecho de la página.

julien
Por supuesto, si necesita ayuda con algo o desea ver funciones adicionales, no dude en comunicarse con nosotros en el cuadro de chat. Por lo general, las implementamos rápidamente.
Potencia
¿Necesita ayuda?

Envíenos un mensaje en el cuadro de chat. Un desarrollador le responderá lo antes posible para responder sus preguntas.

¿No es desarrollador?

Podemos ayudarlo a integrar nuestra API. Envíenos un mensaje en el cuadro de chat.

Authentification

La API de las empresas utiliza tokens de API para autenticar las solicitudes. Puede gestionar sus tokens de API en sus parámetros o en el lado derecho de esta sección.

Hay dos formas de autenticar sus solicitudes HTTP a la API:

Al agregar un encabezado "Authorization". El encabezado "Authorization" se formatea como sigue: "Authorization: Basic MY-API-TOKEN" (reemplace "MY-API-TOKEN" con uno de los suyos).

Al enviar el token de API como un parámetro "GET". Como esto "?token=MY-API-TOKEN" (principalmente utilizado para probar rápidamente un endpoint).

power
Por favor, tenga en cuenta que solo puede usar HTTPS para acceder a la API. HTTP no es compatible.
nada
Sus tokens de API son muy importantes, así que manténgalos seguros! No comparta ellos en áreas públicamente accesibles como GitHub, código del cliente, etc. Estas claves de autenticación son permanentes (no expiran nunca). Puede considerarlas seguras para fines a largo plazo.

Bueno saberlo

Para ayudarte a probar todos nuestros endpoints, tu token de API se incluye automáticamente cuando lo copies.
Potencia

No se encontró ningún token API

Crea un token API para empezar a usar nuestros endpoints.

Errores y Limitación de Tasa

La API de Companies utiliza códigos de respuesta HTTP convencionales para indicar el éxito o fracaso de una solicitud de API. Generalmente, los códigos en el rango 2xx indican éxito. Los códigos en el rango 4xx indican un error que falló dada la información proporcionada (por ejemplo, se omitió un parámetro requerido). Los códigos en el rango 5xx indican un error en nuestros servidores (estos son raros).

Algunos errores 4xx que podrían manejarse programáticamente incluyen un código de error que explica brevemente qué salió mal.

Objeto de error

error. codestring

Para algunos errores que podrían manejarse programáticamente, un número que indica el código de error reportado.

403

error. messagestring

Un mensaje que proporciona más detalles sobre el error.

Missing API token

error. typestring

El tipo de error devuelto (ver la lista a su derecha).

apiConnectionError

Valores posibles

apiConnectionError
apiError
authenticationError
invalidRequestError
noCreditsRemaining
rateLimitError
anthony
Cada plan tiene su propia limitación con respecto al número de solicitudes por segundo que puede realizar. Startup: 50 RPS, Scaleup: 250 RPS, Enterprise: 1,000 RPS.
Resumen de códigos de estado HTTP
200 - OKLa solicitud fue exitosa.
400 - Solicitud IncorrectaLa solicitud fue inaceptable, a menudo debido a la falta de un parámetro requerido.
401 - No AutorizadoNo se proporcionó un token de API válido.
402 - Solicitud FallidaLos parámetros eran válidos, pero la solicitud falló.
403 - ProhibidoEl token de API no tiene permiso para realizar la solicitud.
404 - No EncontradoEl recurso solicitado no existe.
409 - ConflictoLa solicitud entra en conflicto con otra solicitud (quizás debido al uso de la misma clave idempotente).
429 - Demasiadas SolicitudesDemasiadas solicitudes golpearon la API muy rápidamente. Recomendamos un retroceso exponencial de sus solicitudes.
500, 502, 503, 504 - Errores del ServidorAlgo salió mal en nuestro lado. Estos errores raros deben ser reportados, pero los capturamos con PostHog y los arreglamos tan pronto como ocurren.
Resumen de tipos de errores HTTP
apiConnectionErrorFallo al conectar con la API de Companies.
apiErrorLos errores de API cubren cualquier otro tipo de problema (por ejemplo, un problema temporal con los servidores de la API de Companies) y son extremadamente poco comunes.
authenticationErrorFallo al autenticarse correctamente en la solicitud.
invalidRequestErrorLos errores de solicitud inválida surgen cuando su solicitud tiene parámetros inválidos.
noCreditsRemainingNo tiene créditos restantes para hacer esta solicitud.
rateLimitErrorDemasiadas solicitudes golpearon la API muy rápidamente. Recomendamos un retroceso exponencial de sus solicitudes.

Webhooks

The Companies API utiliza webhooks para notificarte sobre cambios o cuando una operación termina. Puedes gestionar tus webhooks en el lado derecho de esta sección o en tus ajustes.

Los webhooks son útiles para recibir los resultados de nuestros algoritmos. Por ejemplo, cuando una nueva empresa que has solicitado ha sido rastreada.

julien
Estamos siempre buscando nuevas formas de usar webhooks. Si tienes alguna sugerencia, no dudes en decírnoslo.
Potencia

No se encontró ningún webhook

Crea un webhook para recibir una notificación para eventos importantes.

Empresas

Encontrarás todas nuestras funcionalidades relacionadas con nuestra base de datos de empresas a continuación.

Busca empresas con una condición específica o por nombre. Recupera el perfil de una empresa en particular proporcionando su nombre de dominio o una de sus URLs de redes sociales.

¿También necesitas obtener empresas similares o incluso los patrones de correo electrónico que utilizan? ¡Nosotros también!

power
Un concepto importante a tener en cuenta es que representamos una empresa por su nombre de dominio (por ejemplo, microsoft.com). Esto es lo que usamos como clave única. Eso significa que cuando descubrimos un nuevo nombre de dominio, lo consideramos una nueva empresa.
Puntos finales
GET
https://api.thecompaniesapi.com/v2/companies
GET
https://api.thecompaniesapi.com/v2/companies/by-name
GET
https://api.thecompaniesapi.com/v2/companies/by-prompt
GET
https://api.thecompaniesapi.com/v2/companies/similar
GET
https://api.thecompaniesapi.com/v2/companies/count
GET
https://api.thecompaniesapi.com/v2/companies/:domain
GET
https://api.thecompaniesapi.com/v2/companies/by-email
GET
https://api.thecompaniesapi.com/v2/companies/by-social
GET
https://api.thecompaniesapi.com/v2/companies/:domain/email-patterns
POST
https://api.thecompaniesapi.com/v2/companies/:domain/ask
GET
https://api.thecompaniesapi.com/v2/companies/:domain/context
GET
https://api.thecompaniesapi.com/v2/companies/analytics
GET
https://api.thecompaniesapi.com/v2/companies/analytics/export

Buscar empresas

1 crédito por empresa

¿Necesitas buscar empresas ubicadas en un país específico para un sector de actividad específico y que usan una tecnología en particular? Combina nuestras condiciones y crea consultas de búsqueda potentes para identificarlas.

¿Quieres construir un motor de búsqueda de empresas potente en tu aplicación? Hemos escrito un guía para ayudarte a hacerlo.

Parámetros de consulta

querystring (requerido)

Un array de condiciones que las empresas deben cumplir.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/companies?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
domainsToExcludestring (opcional)

Una lista de dominios separados por comas para excluir de los resultados.

/companies?domainsToExclude=amazon.com,pearson.com

linkedinToExcludestring (opcional)

Una lista de URLs de LinkedIn separadas por comas para excluir de los resultados.

/companies?linkedinToExclude=https://www.linkedin.com/company/amazon,https://www.linkedin.com/company/pearson

pagenumber (opcional)

La página a recuperar (por defecto 1).

/companies?page=1

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la empresa o al dominio.

/companies?search=amazon

searchFieldsarray (opcional)

Defina los campos para buscar.

/companies?searchFields[]=domain&searchFields[]=name

Valores posibles

about.name
domain.domain
simplifiedboolean (opcional)

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?simplified=true

Valores posibles

false
true
sizenumber (opcional)

El número de empresas a devolver (entre 1 y 100). Por defecto 10.

/companies?size=10

sortFieldsstring (opcional)

Un array de múltiples campos combinados para ordenar los resultados.

…/companies?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.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/companies?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/companies?sortOrder=asc

Valores posibles

asc
desc

Respuesta

companiesarray

Las empresas que coinciden con tus condiciones.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

queryarray

Las condiciones que las empresas deben cumplir.

nada
Para ayudarte a crear tus primeras condiciones, hemos diseñado un generador encima. También nos encantaría ayudarte si lo necesitas.
Puntos finales
GET
https://api.thecompaniesapi.com/v2/companies
POST
https://api.thecompaniesapi.com/v2/companies

Buscar empresas por nombre

1 crédito por empresa

Recupera un perfil de empresa proporcionando el nombre de la empresa. 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.

Parámetros de consulta

namestring (requerido)

El nombre de la empresa.

…/companies/by-name?name=microsoft

pagenumber (opcional)

La página a recuperar (por defecto 1).

/companies/by-name?page=1

countriesstring (opcional)

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

ad
ae
af
ag
ai
al
am
ao
aq
ar
Mostrar 238 más
exactWordsMatchboolean (opcional)

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

listsToExcludestring (opcional)

IDs de tus listas separados por comas que contienen las empresas a excluir de los resultados.

/companies/by-name?listsToExclude=3920,3925

searchFieldsarray (opcional)

attributes.searchFields

/companies?searchFields[]=domain&searchFields[]=name

Valores posibles

about.name
domain.domain
simplifiedboolean (opcional)

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

false
true
sizenumber (opcional)

El número de empresas a devolver (entre 1 y 25). Por defecto a 1.

/companies/by-name?name=amazon&size=2

sortFieldsstring (opcional)

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.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/companies/by-name?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/companies/by-name?sortOrder=asc

Valores posibles

asc
desc

Respuesta

companiesarray

Las empresas que coinciden con el nombre.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

julien
Si tienes el nombre de dominio de una empresa, es mejor usarlo. Lo usamos como clave única en nuestra base de datos. Ver nuestro endpoint de abajo.
Punto final
GET
https://api.thecompaniesapi.com/v2/companies/by-name

Buscar empresas utilizando un prompt

1 crédito por empresa

Describe las empresas que estás buscando y nuestro modelo de IA las encontrará para ti. Puedes ajustar el umbral de similitud para mejorar la precisión de tus resultados.

Parámetros de consulta

promptstring (requerido)

El prompt que nuestro modelo de IA utilizará para buscar empresas.

…/companies/by-prompt?prompt=universities in the united states

listsToExcludestring (opcional)

Los identificadores separados por comas de tus listas que contienen las empresas a excluir de los resultados.

/companies/by-prompt?listsToExclude=3920,3925

pagenumber (opcional)

La página a recuperar (por defecto 1).

/companies/by-prompt?page=1

similaritynumber (opcional)

El umbral de similitud a utilizar para la búsqueda (entre 0 y 1). Por defecto a 0.75.

/companies/by-prompt?similarity=0.75

simplifiedboolean (opcional)

Si se debe devolver una versión simplificada del perfil de la empresa. Por defecto a false.

/companies/by-prompt?simplified=true

sizenumber (opcional)

El número de empresas a devolver (entre 1 y 25). Por defecto a 10.

/companies/by-prompt?size=10

sortFieldsstring (opcional)

Un array de múltiples campos combinados para ordenar los resultados.

…/companies/by-prompt?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.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/companies/by-prompt?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/companies/by-prompt?sortOrder=asc

Valores posibles

asc
desc

Respuesta

companiesarray

La lista de empresas que coinciden con tu prompt.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/by-prompt?prompt=universities in the united states

Buscar empresas similares (competidores, tus clientes, etc.)

5 créditos por empresa similar

Envía uno o más nombres de dominio y te devolvemos una lista de empresas similares.

Parámetros de consulta

domainsarray (requerido)

Una lista de nombres de dominio separados por comas.

…/companies/similar?domains[]=microsoft.com&domains[]=wix.com

pagenumber (opcional)

La página a recuperar (por defecto 1).

/companies/similar?domains[]=…&page=1

simplifiedboolean (opcional)

Return a simplified version of the companies (no credits deducted but limitation are applied on the free plan). It is useful for previewing the data before fetching the full version. Default to false.

/companies/similar?domains[]=…&simplified=true

Valores posibles

false
true
sizenumber (opcional)

El número de empresas similares a devolver (entre 1 y 100). Por defecto a 10.

/companies/similar?domains[]=…&size=50

sortFieldsstring (opcional)

Un array de múltiples campos combinados para ordenar los resultados.

…/companies/similar?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.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/companies/similar?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/companies/similar?sortOrder=asc

Valores posibles

asc
desc

Respuesta

companiesarray

Las empresas similares para tu lista de nombres de dominio.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

julien
Esta función de la API es una de las más potentes. Puedes usarla para encontrar empresas similares a tu propia empresa, o para encontrar empresas similares a tus clientes. También puedes usarla para encontrar empresas similares a tus competidores. Las posibilidades son infinitas.
Punto final
GET
https://api.thecompaniesapi.com/v2/companies/similar?domains[]=microsoft.com&page=1&size=10

Contar las empresas que coinciden con su filtro

Gratis

Cuenta las empresas que coinciden con su filtro. Útil si estás construyendo tu propio motor de búsqueda de empresas.

Parámetros de consulta

querystring (requerido)

Un array de condiciones que las empresas deben cumplir.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/companies/count?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la empresa o al dominio.

/companies/count?search=amazon

searchFieldsarray (opcional)

Defina los campos para buscar.

/companies/count?searchFields[]=domain&searchFields[]=name

Valores posibles

about.name
domain.domain

Respuesta

countnumber

El número de empresas que coinciden con las condiciones.

Puntos finales
GET
https://api.thecompaniesapi.com/v2/companies/count
POST
https://api.thecompaniesapi.com/v2/companies/count

Enriquecer una empresa a partir de un nombre de dominio

1 crédito por enriquecimiento

Enriquece una empresa enviándonos su nombre de dominio. El nombre de dominio es un mejor identificador que el nombre de la empresa porque es único y menos susceptible a errores de tipeo.

Parámetros de consulta

domainstring (requerido)

El nombre de dominio de la empresa (por ejemplo: apple.com, microsoft.com).

microsoft.com

simplifiedboolean (opcional)

Cuando se establece en true, devuelve una versión simplificada de los datos de la empresa. La llamada es gratuita y no se descontarán créditos.

/companies/microsoft.com?simplified=true

refreshboolean (opcional)

Cuando se establece en true, activa una actualización en tiempo real de los datos de la empresa, incluyendo rastreo del sitio web, análisis de redes sociales y enriquecimiento mediante IA. Nota: esta operación cuesta 10 créditos adicionales por solicitud.

/companies/microsoft.com?refresh=true

Respuesta

company. aboutobject

Información general sobre la empresa.

company. analyticsobject

Datos analíticos y rendimiento del sitio web.

company. appsobject

Información sobre las aplicaciones que ofrece la empresa.

company. assetsobject

Recursos de la empresa, incluyendo activos digitales.

company. codesobject

Códigos de clasificación industrial estándar para la empresa y otros códigos de identificación.

company. companiesobject

Detalles sobre empresas relacionadas como adquisiciones y subsidiarias.

company. contactsobject

Información de contacto incluyendo correos electrónicos y teléfonos.

company. contentsobject

Contenido proporcionado por la empresa como blogs, podcasts y más.

company. descriptionsobject

Descripciones de la empresa y palabras clave asociadas convertidas al inglés con nuestra IA.

company. domainobject

Detalles sobre el nombre de dominio de la empresa.

company. financesobject

Datos financieros e información de ingresos sobre la empresa.

company. locationsobject

Ubicaciones geográficas y sedes de la empresa.

company. metaobject

Información meta sobre la empresa.

company. secondariesobject

Información adicional sobre la empresa que no pudimos categorizar.

company. socialsobject

Enlaces de redes sociales de la empresa y métricas.

company. technologiesobject

Tecnologías utilizadas por la empresa.

company. urlsobject

URLs relacionadas con la empresa.

power
Devolvemos más de 50 puntos de datos, incluyendo las industrias, el volumen de negocios, las tecnologías… Si necesitas algo que no tenemos aún, no dudes en decírnoslo.
Punto final
GET
https://api.thecompaniesapi.com/v2/companies/microsoft.com
200 - OK
404 - No encontrado

Enriquecer una empresa a partir de un email

1 crédito por enriquecimiento

Enriquecer una empresa enviando un email.

¿Quieres enriquecer a tus usuarios al registrarse con datos de empresa precisos? Hemos escrito un guía para ayudarte a hacerlo.

Parámetros de consulta

emailstring (requerido)

El email a enriquecer.

/companies/[email protected]

simplifiedboolean (opcional)

Cuando se establece en true, devuelve una versión simplificada de los datos de la empresa. La llamada es gratuita y no se descontarán créditos.

/companies/[email protected]&simplified=true

refreshboolean (opcional)

Cuando se establece en true, activa una actualización en tiempo real de los datos de la empresa, incluyendo rastreo del sitio web, análisis de redes sociales y enriquecimiento mediante IA. Nota: esta operación cuesta 10 créditos adicionales por solicitud.

/companies/microsoft.com?refresh=true

Respuesta

companyobject

El perfil de la empresa desde nuestra base de datos.

Explorar todos los puntos de datos
emailobject

Información adicional sobre el email.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/[email protected]
200 - OK
404 - No encontrado
400 - Email inválido

Enriquecer una empresa a partir de una URL de red social (LinkedIn, Instagram, etc.)

1 crédito por enriquecimiento

Recupera el perfil de una empresa enviándonos una URL de red social (ver la lista de abajo para los que aceptamos).

Parámetros de consulta

dribbblestring (opcional)

La URL Dribbble de la empresa.

/companies/by-social?dribbble=https://dribbble.com/microsoft

facebookstring (opcional)

La URL Facebook de la empresa.

/companies/by-social?facebook=https://www.facebook.com/microsoft

githubstring (opcional)

La URL GitHub de la empresa.

/companies/by-social?github=https://github.com/microsoft

instagramstring (opcional)

La URL Instagram de la empresa.

/companies/by-social?instagram=https://www.instagram.com/microsoft

linkedinstring (opcional)

La URL LinkedIn de la empresa. Gestionamos tanto las URLs alfa (/company/microsoft) como los identificadores numéricos (/company/6585).

/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft

pintereststring (opcional)

La URL Pinterest de la empresa.

/companies/by-social?pinterest=https://www.pinterest.com/microsoft

snapchatstring (opcional)

La URL Snapchat de la empresa.

/companies/by-social?snapchat=https://www.snapchat.com/add/microsoft

tiktokstring (opcional)

La URL TikTok de la empresa.

/companies/by-social?tiktok=https://www.tiktok.com/@microsoft

twitterstring (opcional)

La URL Twitter de la empresa.

/companies/by-social?twitter=https://twitter.com/microsoft

wellfoundstring (opcional)

La URL Wellfound de la empresa.

/companies/by-social?wellfound=https://wellfound.com/company/microsoft

youtubestring (opcional)

La URL YouTube de la empresa.

/companies/by-social?youtube=https://www.youtube.com/@microsoft

refreshboolean (opcional)

Cuando se establece en true, activa una actualización en tiempo real de los datos de la empresa, incluyendo rastreo del sitio web, análisis de redes sociales y enriquecimiento mediante IA. Nota: esta operación cuesta 10 créditos adicionales por solicitud.

/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft&refresh=true

Respuesta

company. aboutobject

Información general sobre la empresa.

company. analyticsobject

Datos analíticos y rendimiento del sitio web.

company. appsobject

Información sobre las aplicaciones que ofrece la empresa.

company. assetsobject

Recursos de la empresa, incluyendo activos digitales.

company. codesobject

Códigos de clasificación industrial estándar para la empresa y otros códigos de identificación.

company. companiesobject

Detalles sobre empresas relacionadas como adquisiciones y subsidiarias.

company. contactsobject

Información de contacto incluyendo correos electrónicos y teléfonos.

company. contentsobject

Contenido proporcionado por la empresa como blogs, podcasts y más.

company. descriptionsobject

Descripciones de la empresa y palabras clave asociadas convertidas al inglés con nuestra IA.

company. domainobject

Detalles sobre el nombre de dominio de la empresa.

company. financesobject

Datos financieros e información de ingresos sobre la empresa.

company. locationsobject

Ubicaciones geográficas y sedes de la empresa.

company. metaobject

Información meta sobre la empresa.

company. secondariesobject

Información adicional sobre la empresa que no pudimos categorizar.

company. socialsobject

Enlaces de redes sociales de la empresa y métricas.

company. technologiesobject

Tecnologías utilizadas por la empresa.

company. urlsobject

URLs relacionadas con la empresa.

yael
Se pueden enviar varias URLs de redes sociales (por ejemplo, LinkedIn y YouTube), y las verificaremos en el orden en que se proporcionan hasta que encontramos una empresa que coincida con alguna de ellas.
Punto final
GET
https://api.thecompaniesapi.com/v2/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft
200 - OK
404 - No encontrado

Encontrar patrones de correo electrónico de una empresa

1 crédito

Envía un nombre de dominio y recupera todos los formatos de correo electrónico que utilizan con el porcentaje de uso.

Parámetros de consulta

domainstring (requerido)

El nombre de dominio de la empresa.

…/companies/microsoft.com/email-patterns

Respuesta

patternsarray

Los formatos de email utilizados.

power
Utilizamos esta función internamente para priorizar los patrones cuando queremos adivinar y verificar una dirección de correo electrónico profesional con API externas. Puedes usar esta API para reducir el número de llamadas a herramientas como MailboxLayer o Debounce (y por lo tanto tus costos).
Punto final
GET
https://api.thecompaniesapi.com/v2/companies/microsoft.com/email-patterns

Hacer una pregunta sobre una empresa a nuestro modelo de IA

10 créditos por pregunta

Hacer preguntas sobre una empresa usando nuestro modelo de IA. Puedes especificar el modelo a usar (pequeño o grande) y opcionalmente proporcionar campos para estructurar la respuesta. El modelo grande es más caro pero proporciona respuestas más detalladas.

Parámetros de consulta

domainstring (requerido)

El dominio de la empresa sobre la que quieres hacer una pregunta.

…/companies/microsoft.com/ask

questionstring (requerido)

La pregunta a hacer al modelo de IA.

What products does this company offer?

fieldsobject

Un array de definiciones de campos simplificadas para la respuesta.

Si no lo proporcionas, el modelo generará un esquema de respuesta basado en tu pregunta.

Los posibles valores para cada campo:

- `description`: Una descripción opcional del campo.

- `key`: Una cadena de caracteres, generalmente en camelCase. (required)

- `type`: El tipo de campo. (required)

[{"description":"The products that the company offers","key":"products","type":"array|string"}]

modelstring

El modelo a utilizar para la pregunta.

large

Valores posibles

large
small

Respuesta

answerobject

La respuesta a la pregunta en una forma estructurada.

metaobject

La información meta sobre la respuesta.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/:domain/ask

Recuperar el contexto de una empresa

5 créditos por contexto

Este endpoint te permite recuperar insights generados por IA sobre una empresa. Nuestra IA analiza el sitio web de la empresa y otras fuentes autorizadas para extraer y sintetizar información clave en un contexto completo. Esto incluye detalles sobre su modelo de negocio, mercado objetivo, ventajas competitivas y otras estrategias que pueden no ser evidentes desde datos de la empresa sin procesar.

Parámetros de consulta

domainstring (requerido)

El dominio de la empresa para la que se desea recuperar el contexto.

…/companies/microsoft.com/context

Respuesta

contextobject

El contexto de la empresa.

metaobject

La información meta sobre la respuesta.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/:domain/context

Obtener datos de análisis para una consulta o tus listas

Gratis

Analice y obtenga información soxbre empresas que coincidan con sus criterios especificados. Puede explorar varios atributos incluyendo tipo de negocio, industria, número de empleados y más. Este endpoint también permite exportar datos en múltiples formatos.

Parámetros de consulta

attributestring (requerido)

El atributo de análisis para agregar datos. Determina qué campo se utilizará para agrupar y analizar las empresas.

Valores posibles

about.businessType
about.industries
about.industry
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
contacts
Mostrar 13 más
queryarray (opcional)

Una matriz de condiciones para filtrar las empresas.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/companies/analytics?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
listIdsarray (opcional)

Filtrar análisis a listas específicas.

sizenumber (opcional)

El número máximo de empresas a incluir en el análisis (entre 1 y 10,000). El valor por defecto es 100.

Valores posibles

1-10000
sortstring (opcional)

El orden de clasificación de los resultados.

Valores posibles

asc
desc

Respuesta

dataarray

Matriz de métricas agregadas (recuentos y porcentajes) para cada valor del atributo especificado.

metaobject

Metadatos adicionales sobre los resultados.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/analytics

Exportar datos de análisis

Gratis

Exporte datos de análisis sobre empresas en varios formatos. Puede elegir atributos específicos para exportar u obtener una exportación completa de todos los atributos de análisis. El endpoint devuelve una descarga de archivo en el formato elegido.

Parámetros de consulta

actionIdnumber (opcional)

El ID de la acción para filtrar los análisis.

attributesarray (opcional)

Una matriz de atributos de análisis para exportar. Requerido si full no es verdadero.

Valores posibles

about.businessType
about.industries
about.industry
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
contacts
Mostrar 13 más
formatstring (opcional)

El formato del archivo exportado (por defecto json).

Valores posibles

csv
json
txt
xls
xml
fullboolean (opcional)

Si se deben exportar todos los atributos de análisis.

listIdnumber (opcional)

Filtrar análisis a lista específica.

queryarray (opcional)

Una matriz de condiciones para filtrar las empresas.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/companies/analytics/export?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
sizenumber (opcional)

Le nombre de résultats à retourner.

sortstring (opcional)

L'ordre de tri des résultats.

Valores posibles

asc
desc

Respuesta

dataobject

Un array de puntos de datos de análisis que contienen conteos y porcentajes para cada valor

metaobject

Metadatos adicionales sobre los resultados.

Punto final
GET
https://api.thecompaniesapi.com/v2/companies/analytics/export

Acciones

A continuación, encontrarás una visión general completa de las acciones que puedes realizar con las empresas.

Estas acciones son particularmente poderosas para automatizar procesos dentro de tu producto utilizando nuestra API.

Te permiten no solo enriquecer empresas que no están todavía en nuestra base de datos, sino también realizar un enriquecimiento más detallado en caso de que sea necesario (como extraer productos para un sitio web de comercio electrónico).

power
Dado que las acciones son una nueva funcionalidad en nuestro producto, no dudes en contactarnos con cualquier idea para acciones adicionales. Estaríamos encantados de discutirlas contigo.
Puntos finales
POST
https://api.thecompaniesapi.com/v2/actions
GET
https://api.thecompaniesapi.com/v2/actions

Solicitar una acción en una o más empresas

10 créditos por acción

Este endpoint te permite solicitar una acción para una sola empresa, múltiples empresas o una lista completa de empresas.

Parámetros del cuerpo

domainsarray (Longitud máxima: 100) (opcional)

Los dominios que necesitan ser procesados. Si pasas más de 100K dominios, la solicitud se dividirá en múltiples acciones.

["pearson.com","united.com"]

estimateboolean (opcional)

Indica si estás solicitando una estimación de precio.

Valores posibles

false
true
jobstring (opcional)

El tipo de tarea a realizar.

Valores posibles

enrich-companies
enrich-list
listnumber (opcional)

El ID de la lista a procesar.

42

Respuesta

actionsarray

Las acciones que han sido desencadenadas por la solicitud.

estimateboolean

Indica si estás solicitando una estimación de precio.

Punto final
POST
https://api.thecompaniesapi.com/v2/actions
Respuesta de la API
{actions :[{cost :10,createdAt : "2024-08-23T17:02:47.296+02:00" ,data :{…},status : "pending" ,type : "jobs:request" ,},],estimate :true,}

Obtener los detalles de tus acciones

Gratis

Este endpoint te permite recuperar tus solicitudes de acciones más recientes.

Parámetros de consulta

fullboolean (opcional)

Si se deben obtener los detalles completos de la acción.

false

idsarray (opcional)

Los IDs de las acciones a obtener.

[1,2]

listIdnumber (opcional)

El ID de la lista para la que se obtendrán las acciones.

1

pagenumber (opcional)

La página a recuperar (por defecto es 1).

1

sizenumber (opcional)

El número de acciones que se devolverán (entre 1 y 25). Por defecto es 10.

10

statusstring (opcional)

El estado de las acciones a recuperar.

Valores posibles

pending
completed
active
failed

Respuesta

actionsarray

La lista de acciones.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/actions
Respuesta de la API
{actions :[{cost :10,createdAt : "2024-08-23T17:02:47.296+02:00" ,data :{…},id :42,status : "pending" ,type : "jobs:request" ,updatedAt : "2024-08-23T17:02:47.296+02:00" ,},{cost :10,createdAt : "2024-08-23T17:02:40.000+02:00" ,data :{…},id :40,status : "completed" ,type : "jobs:request" ,updatedAt : "2024-08-23T17:02:40.000+02:00" ,},],meta :{currentPage :1,firstPage :1,lastPage :1,perPage :10,total :2,},}

Industries

Busca industrias específicas y obtén información como el número de empresas que contiene.

nada
Actualmente tenemos más de 3 millones de industrias en nuestra base de datos. Podemos enviarte un archivo con nuestras 100,000 industrias más populares si quieres usarlo en tu aplicación.
Puntos finales
GET
https://api.thecompaniesapi.com/v2/industries
GET
https://api.thecompaniesapi.com/v2/industries/similar

Buscar industrias

Gratis

Busca en nuestra base de datos de industrias y obtén información como el número de empresas que contiene. Los resultados se ordenan por "companies_count".

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto 1).

/industries?page=1

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la industria.

/industries?search=saas

sizenumber (opcional)

El número de industrias a devolver (entre 1 y 100). Por defecto 25.

/industries?size=10

Respuesta

industriesarray

Las industrias que coinciden con tus criterios.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/industries

Buscar industrias similares

Gratis

Descubre industrias similares con nuestra API. Identifica sectores relacionados y amplía tus oportunidades comerciales.

Parámetros de consulta

industriesarray (requerido)

Las industrias para comparar (máx. 10).

/industries/similar?industries[]=saas&industries[]=fintech

pagenumber (opcional)

La página a recuperar (por defecto 1).

/industries/similar?page=1

sizenumber (opcional)

El número de industrias a devolver (entre 1 y 100). Por defecto a 25.

/industries/similar?size=10

Respuesta

industriesarray

Las industrias que coinciden con tus criterios.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/industries/similar?industries[]=saas&size=10

Tecnologías

Actualmente rastreamos 369 tecnologías. Si necesitas una tecnología que no esté listada, no dudes en hablar con nosotros ya que generalmente nos lleva menos de 48 horas agregarla.

Punto final
GET
https://api.thecompaniesapi.com/v2/technologies

Buscar tecnologías

Gratis

Navega por las tecnologías que identificamos y obtén información como el número de empresas que la utilizan.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto 1).

/technologies?page=1

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la tecnología.

/technologies?search=shopify

sizenumber (opcional)

El número de tecnologías a devolver (entre 1 y 100). Por defecto 25.

/technologies?size=10

Respuesta

technologiesarray

Las tecnologías que identificamos que coinciden con tus condiciones.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/technologies

Localizaciones

Los siguientes endpoints te permiten buscar todas nuestras localizaciones: ciudades, condados, estados, países y continentes.

julien
Puedes usarlos para filtrar nuestras empresas en una ubicación específica.
Puntos finales
GET
https://api.thecompaniesapi.com/v2/locations/cities
GET
https://api.thecompaniesapi.com/v2/locations/counties
GET
https://api.thecompaniesapi.com/v2/locations/countries
GET
https://api.thecompaniesapi.com/v2/locations/states
GET
https://api.thecompaniesapi.com/v2/locations/continents

Buscar ciudades

Gratis

Busca nuestras ciudades para filtrar empresas en una ubicación específica.

Parámetros de consulta

pagenumber (opcional)

La página a obtener (por defecto 1).

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la ciudad.

sizenumber (opcional)

El número de ciudades a devolver (entre 1 y 20). Por defecto 10.

Respuesta

citiesarray

Las ciudades que coinciden con tus condiciones.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/locations/cities

Buscar departamentos

Gratis

Busca en nuestra base de datos de departamentos para filtrar empresas en un lugar específico.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto 1).

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre del departamento.

sizenumber (opcional)

El número de departamentos a devolver (entre 1 y 20). Por defecto 10.

Respuesta

countiesarray

Los departamentos que coinciden con tus criterios.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/locations/counties

Buscar estados

Gratis

Busca en nuestra base de datos de estados para filtrar empresas en un lugar específico.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto 1).

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre del estado.

sizenumber (opcional)

El número de estados a devolver (entre 1 y 20). Por defecto 10.

Respuesta

statesarray

Los estados que coinciden con tus criterios.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/locations/states

Buscar países

Gratis

Busca en nuestra base de datos de países para filtrar empresas en un lugar específico.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto 1).

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre del país.

sizenumber (opcional)

El número de países a devolver (entre 1 y 20). Por defecto 10.

Respuesta

countriesarray

Los países que coinciden con tus criterios.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/locations/countries

Buscar continentes

Gratis

Busca en nuestros continentes para filtrar empresas en una ubicación específica.

Parámetros de consulta

pagenumber (opcional)

La página que se va a buscar (por defecto 1).

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre del continente.

sizenumber (opcional)

La cantidad de continentes que se devolverán (entre 1 y 20). Por defecto 10.

Respuesta

continentsarray

Los continentes que coinciden con tus condiciones.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/locations/continents

Profesiones

Encuentra profesiones específicas y obtén información como el número de empresas que contiene.

power
Actualmente tenemos más de 3 millones de profesiones en nuestra base de datos. Podemos enviarte un archivo con nuestras 100,000 profesiones más populares si quieres usarlo en tu aplicación.
Punto final
GET
https://api.thecompaniesapi.com/v2/job-titles/enrich

Enriquecer una profesión a partir de su nombre

Gratis

Envíanos una profesión (por ejemplo, director general) y recupera información adicional como los departamentos y los niveles de responsabilidad. Nosotros soportamos los siguientes idiomas: inglés, francés y español.

Parámetros de consulta

namestring (requerido)

El nombre de la profesión.

/job-titles/enrich?name=chief%20executive%20officer

Respuesta

jobTitle. departmentstring

The job title's department.

marketing

Valores posibles

customer service
design
education
engineering
finance
health
human resources
legal
marketing
media
Mostrar 5 más
jobTitle. departmentSecondarystring

The job title's secondary department.

content marketing

Valores posibles

accounting
accounts
brand marketing
broadcasting
business development
compensation
content marketing
customer success
data
dental
Mostrar 45 más
jobTitle. namestring

The job title's english name.

jobTitle. nameEsstring

The job title's spanish name.

jobTitle. nameFrstring

The job title's french name.

jobTitle. seniorityLevelstring

The job title's seniority level.

Valores posibles

owner
partner
cxo
vp
director
manager
senior
entry
training
unpaid
nada
Nuestra base de datos incluye más de 165,000 profesiones categorizadas en 70 departamentos y 10 niveles de responsabilidad.
Punto final
GET
https://api.thecompaniesapi.com/v2/job-titles/enrich

Listas

Las empresas pueden ser guardadas en tus listas. Los siguientes endpoints te permiten recuperar tus listas y gestionar las empresas que pertenezcan a ellas.

Puntos finales
GET
https://api.thecompaniesapi.com/v2/lists
POST
https://api.thecompaniesapi.com/v2/lists
GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies
PATCH
https://api.thecompaniesapi.com/v2/lists/:listId/companies/toggle

Recuperar tus listas

Gratis

Este endpoint te permite recuperar las listas que pertenezcan a tu equipo.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto: 1).

/lists?page=1

sizenumber (opcional)

El número de listas a recuperar (entre 1 y 100). Por defecto a 10.

/lists?size=10

Respuesta

listsarray

Las listas que pertenezcan a tu equipo.

metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/lists
Respuesta de la API
{lists :[{analytics :{…},createdAt : "2022-04-01T13:07:14.000+00:00" ,dynamic :false,id :4246,imported :false,integrations :[…],name : "US Companies using Node.js" ,processActive :false,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[…],},{analytics :{…},createdAt : "2022-02-22T07:23:52.000+00:00" ,dynamic :false,id :3837,imported :false,integrations :[ ],name : "Edtech Companies" ,processActive :false,processInitialized :true,processingAt : "2022-02-22T07:23:53.000+00:00" ,query :[…],},],meta :{currentPage :1,firstPage :1,lastPage :1,perPage :10,total :4,},}

Crear una lista de empresas

Gratis

Este endpoint te permite crear una lista de empresas.

Parámetros del cuerpo

dynamicboolean (opcional)

Si la lista es dinámica o no. Si se establece en true, la lista se actualizará automáticamente cuando se agreguen nuevas empresas a la base de datos.

Valores posibles

false
true
namestring (requerido)

El nombre de la lista.

typestring (requerido)

El tipo de lista a crear.

Valores posibles

companies

Respuesta

list. analyticsobject

The analytics of the list.

list. createdAtdate

When the list was created.

2022-02-22T07:23:52.000+00:00

list. dynamicboolean

If the list is dynamic or static.

true

list. idnumber

The id of the list.

3838

list. importedboolean

If the list has been imported.

true

list. integrationsarray

The integrations associated with the list.

list. namestring

The name of the list

SaaS with 100k+ MRR

list. processActiveboolean

The process active status of the list (for internal use).

true

list. processInitializedboolean

The process initialized flag (for internal use).

true

list. processingAtdate

When the list is being processed.

2022-02-22T07:23:52.000+00:00

list. queryarray

The query used to generate the list.

Punto final
POST
https://api.thecompaniesapi.com/v2/lists
Respuesta de la API
{analytics :{…},createdAt : "2022-04-01T13:07:14.000+00:00" ,dynamic :false,id :4246,imported :false,integrations :[ ],name : "SaaS with 100k+ MRR" ,processActive :false,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[ ],}

Recuperar las empresas de tu lista

Gratis

Este endpoint te permite recuperar las empresas que pertenezcan a tu lista.

Parámetros de consulta

pagenumber (opcional)

La página a recuperar (por defecto: 1).

/lists/:listId/companies?page=1

sizenumber (opcional)

El número de empresas a recuperar (entre 1 y 100). Por defecto a 10.

/lists/:listId/companies?size=10

querystring (requerido)

La consulta para filtrar las empresas dentro de tu lista.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
sortFieldsstring (opcional)

Un array de múltiples campos combinados para ordenar los resultados.

…/lists/:listId/companies?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.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/lists/:listId/companies?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/lists/:listId/companies?sortOrder=asc

Valores posibles

asc
desc

Respuesta

companiesarray

Las empresas que pertenezcan a tu lista.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

Punto final
GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies

Agregar o eliminar empresas en su lista

1 crédito por empresa agregada

Use este endpoint para gestionar empresas en sus listas añadiendo (attaching) o eliminando (detaching) usando sus dominios o IDs. Puede modificar hasta 1,000 empresas por petición API.

Parámetros de consulta

actionstring (opcional)

La acción a realizar sobre las empresas: 'attach' para agregarlas a la lista, o 'detach' para eliminarlas de la lista.

Valores posibles

attach
detach
domainsarray (opcional)

Un array de dominios de empresas (e.g. ['microsoft.com', 'apple.com']) para agregar o eliminar de la lista. Máximo 1,000 dominios.

companyIdsarray (opcional)

Un array de IDs de empresas para agregar o eliminar de la lista (cada ID para una empresa está disponible en metas.mysqlId). Máximo 1,000 IDs de empresa.

Respuesta

list. analyticsobject

The analytics of the list.

list. createdAtdate

When the list was created.

2022-02-22T07:23:52.000+00:00

list. dynamicboolean

If the list is dynamic or static.

true

list. idnumber

The id of the list.

3838

list. importedboolean

If the list has been imported.

true

list. integrationsarray

The integrations associated with the list.

list. namestring

The name of the list

SaaS with 100k+ MRR

list. processActiveboolean

The process active status of the list (for internal use).

true

list. processInitializedboolean

The process initialized flag (for internal use).

true

list. processingAtdate

When the list is being processed.

2022-02-22T07:23:52.000+00:00

list. queryarray

The query used to generate the list.

Punto final
PATCH
https://api.thecompaniesapi.com/v2/lists/:listId/companies/toggle
Respuesta de la API
{analytics :{companiesCount :30992,},createdAt : "2022-04-01T13:07:14.000+00:00" ,dynamic :false,id :4246,imported :false,integrations :[ ],name : "SaaS with 100k+ MRR" ,processActive :false,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[ ],}

Gestionar tu equipo

Estos endpoints te permiten gestionar y recuperar información detallada sobre el equipo asociado a tu token API.

Punto final
GET
https://api.thecompaniesapi.com/v2/teams/:teamId

Recuperar tu equipo

Gratis

Este endpoint te permite recuperar el equipo asociado a tu token API.

Respuesta

countrystring

El país del equipo.

us

createdAtdate

La fecha de creación del equipo.

2020-06-29 08:21:01

creditsnumber

Los créditos del equipo.

500000

isSubscriberboolean

Si el equipo está suscrito a un plan de pago.

true

idnumber

El id del equipo.

1

namestring

El nombre del equipo.

Jay Gatsby Enterprises

websiteUrlstring

La URL del sitio web del equipo.

https://www.jaygatsbyenterprises.com

Punto final
GET
https://api.thecompaniesapi.com/v2/teams/:teamId
Respuesta de la API
{country : "us" ,createdAt : "2020-06-29 08:21:01" ,credits :500000,id :1,isSubscriber :true,name : "Jay Gatsby Enterprises" ,websiteUrl : "https://www.jaygatsbyenterprises.com" ,}

Utilidades

Nuestros endpoints de utilidades proporcionan herramientas útiles e información sobre nuestra API. Estos incluyen la verificación del estado de salud de la API y la obtención de la especificación OpenAPI.

Puntos finales
GET
https://api.thecompaniesapi.com/
GET
https://api.thecompaniesapi.com/v2/openapi

Obtener estado de salud de la API

Gratis

Verifica el estado de salud de nuestra API y sus diversos servicios.

Respuesta

healthyboolean

Estado de salud general de la API.

nodeNamestring

Nombre del nodo que responde a la solicitud.

reportobject

Informe de salud detallado para cada servicio.

Punto final
GET
https://api.thecompaniesapi.com/

Obtener especificación OpenAPI

Gratis

Obtén la especificación OpenAPI de nuestra API, que proporciona una descripción detallada de todos los endpoints disponibles, parámetros de solicitud y formatos de respuesta.

Respuesta

componentsobject

Componentes reutilizables utilizados en toda la especificación de la API.

externalDocsobject

Documentación externa adicional.

infoobject

Metadatos sobre la API.

openapistring

La versión de la especificación OpenAPI.

pathsobject

Las rutas y operaciones disponibles para la API.

serversarray

Una matriz de objetos de servidor, que proporcionan información de conectividad a un servidor de destino.

webhooksobject

Webhooks entrantes que pueden recibirse como parte de esta API.

Punto final
GET
https://api.thecompaniesapi.com/v2/openapi
Una imagen de fondo brillante para resaltar el títuloUna imagen de fondo brillante para resaltar el título
© 2025 The Companies API
  • Actualizaciones
  • Términos
  • Privacidad
  • Preguntas frecuentes
  • Estado

Empresas SaaS de rápido crecimiento con equipos remotos