Tu API de enriquecimiento para impulsar tu producto y tu marketing
Busca empresas, enriquece una lista de dominios y encuentra negocios similares.
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.
Envíenos un mensaje en el cuadro de chat. Un desarrollador le responderá lo antes posible para responder sus preguntas.
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).
Bueno saberlo
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
Para algunos errores que podrían manejarse programáticamente, un número que indica el código de error reportado.
403
Un mensaje que proporciona más detalles sobre el error.
Missing API token
El tipo de error devuelto (ver la lista a su derecha).
apiConnectionError
Valores posibles
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.
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!
Buscar empresas
¿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 hecho una guía para esto.Parámetros de consulta
Un array de condiciones que las empresas deben cumplir.
Asegúrate de que este parámetro esté convertido a cadena y codificado.
Una lista de dominios separados por comas para excluir de los resultados.
/companies?domainsToExclude=amazon.com,pearson.com
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
La página a recuperar (por defecto 1).
/companies?page=1
Una consulta de búsqueda adicional aplicada al nombre de la empresa o al dominio.
/companies?search=amazon
Defina los campos para buscar.
/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?simplified=true
Valores posibles
El número de empresas a devolver (entre 1 y 100). Por defecto 10.
/companies?size=10
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.
El campo para ordenar los resultados.
…/companies?sortKey=meta.score
Valores posibles
El orden para ordenar los resultados.
…/companies?sortOrder=asc
Valores posibles
Respuesta
La información de metadatos.
Las condiciones que las empresas deben cumplir.
Buscar empresas por nombre
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
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
Respuesta
La información de metadatos.
Buscar empresas utilizando un prompt
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
El prompt que nuestro modelo de IA utilizará para buscar empresas.
…/companies/by-prompt?prompt=universities in the united states
Los identificadores separados por comas de tus listas que contienen las empresas a excluir de los resultados.
/companies/by-prompt?listsToExclude=3920,3925
La página a recuperar (por defecto 1).
/companies/by-prompt?page=1
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
Si se debe devolver una versión simplificada del perfil de la empresa. Por defecto a false.
/companies/by-prompt?simplified=true
El número de empresas a devolver (entre 1 y 25). Por defecto a 10.
/companies/by-prompt?size=10
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.
El campo para ordenar los resultados.
…/companies/by-prompt?sortKey=meta.score
Valores posibles
El orden para ordenar los resultados.
…/companies/by-prompt?sortOrder=asc
Valores posibles
Respuesta
La información de metadatos.
Buscar empresas similares (competidores, tus clientes, etc.)
Envía uno o más nombres de dominio y te devolvemos una lista de empresas similares.
Parámetros de consulta
Una lista de nombres de dominio separados por comas.
…/companies/similar?domains[]=microsoft.com&domains[]=wix.com
La página a recuperar (por defecto 1).
/companies/similar?domains[]=…&page=1
El número de empresas similares a devolver (entre 1 y 100). Por defecto a 10.
/companies/similar?domains[]=…&size=50
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.
El campo para ordenar los resultados.
…/companies/similar?sortKey=meta.score
Valores posibles
El orden para ordenar los resultados.
…/companies/similar?sortOrder=asc
Valores posibles
Respuesta
Las empresas similares para tu lista de nombres de dominio.
globals.browseAllDatapointsLa información de metadatos.
Enriquecer una empresa a partir de un nombre de dominio
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
El nombre de dominio de la empresa.
microsoft.com
Respuesta
Información general sobre la empresa.
Datos analíticos y rendimiento del sitio web.
Información sobre las aplicaciones que ofrece la empresa.
Recursos de la empresa, incluyendo activos digitales.
Ofertas de trabajo y oportunidades de carrera en la empresa.
Códigos de clasificación industrial estándar para la empresa y otros códigos de identificación.
Detalles sobre empresas relacionadas como adquisiciones y subsidiarias.
Información de contacto incluyendo correos electrónicos y teléfonos.
Contenido proporcionado por la empresa como blogs, podcasts y más.
Descripciones de la empresa y palabras clave asociadas convertidas al inglés con nuestra IA.
Detalles sobre el nombre de dominio de la empresa.
Datos financieros e información de ingresos sobre la empresa.
Información legal y políticas de la empresa.
Ubicaciones geográficas y sedes de la empresa.
Información meta sobre la empresa.
Detalles sobre los productos ofrecidos por la empresa.
Información adicional sobre la empresa que no pudimos categorizar.
Enlaces de redes sociales de la empresa y métricas.
Tecnologías utilizadas por la empresa.
Enriquecer una empresa a partir de un email
Enriquecer una empresa enviando un email.
Parámetros de consulta
Retornar una versión simplificada del esquema de la empresa.
/companies/[email protected]&simplified=true
Respuesta
Enriquecer una empresa a partir de una URL de red social (LinkedIn, Instagram, etc.)
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
La URL Dribbble de la empresa.
/companies/by-social?dribbble=https://dribbble.com/microsoft
La URL Facebook de la empresa.
/companies/by-social?facebook=https://www.facebook.com/microsoft
La URL GitHub de la empresa.
/companies/by-social?github=https://github.com/microsoft
La URL Instagram de la empresa.
/companies/by-social?instagram=https://www.instagram.com/microsoft
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
La URL Pinterest de la empresa.
/companies/by-social?pinterest=https://www.pinterest.com/microsoft
La URL Snapchat de la empresa.
/companies/by-social?snapchat=https://www.snapchat.com/add/microsoft
La URL TikTok de la empresa.
/companies/by-social?tiktok=https://www.tiktok.com/@microsoft
La URL Twitter de la empresa.
/companies/by-social?twitter=https://twitter.com/microsoft
La URL Wellfound de la empresa.
/companies/by-social?wellfound=https://wellfound.com/company/microsoft
La URL YouTube de la empresa.
/companies/by-social?youtube=https://www.youtube.com/@microsoft
Respuesta
Información general sobre la empresa.
Datos analíticos y rendimiento del sitio web.
Información sobre las aplicaciones que ofrece la empresa.
Recursos de la empresa, incluyendo activos digitales.
Ofertas de trabajo y oportunidades de carrera en la empresa.
Códigos de clasificación industrial estándar para la empresa y otros códigos de identificación.
Detalles sobre empresas relacionadas como adquisiciones y subsidiarias.
Información de contacto incluyendo correos electrónicos y teléfonos.
Contenido proporcionado por la empresa como blogs, podcasts y más.
Descripciones de la empresa y palabras clave asociadas convertidas al inglés con nuestra IA.
Detalles sobre el nombre de dominio de la empresa.
Datos financieros e información de ingresos sobre la empresa.
Información legal y políticas de la empresa.
Ubicaciones geográficas y sedes de la empresa.
Información meta sobre la empresa.
Detalles sobre los productos ofrecidos por la empresa.
Información adicional sobre la empresa que no pudimos categorizar.
Enlaces de redes sociales de la empresa y métricas.
Tecnologías utilizadas por la empresa.
Enriquecer una empresa con sus formatos de email
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
El nombre de dominio de la empresa.
…/companies/microsoft.com/email-patterns
Respuesta
Los formatos de email utilizados.
Contar las empresas que coinciden con su filtro
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
Un array de condiciones que las empresas deben cumplir.
Asegúrate de que este parámetro esté convertido a cadena y codificado.
Una consulta de búsqueda adicional aplicada al nombre de la empresa o al dominio.
/companies/count?search=amazon
Defina los campos para buscar.
/companies/count?searchFields[]=domain&searchFields[]=name
Valores posibles
Respuesta
El número de empresas que coinciden con las condiciones.
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).
Solicitar una acción en una o más empresas
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
Los dominios que necesitan ser procesados.
["pearson.com","united.com"]
Indica si estás solicitando una estimación de precio.
Valores posibles
El tipo de tarea a realizar.
Valores posibles
El ID de la lista a procesar.
42
Respuesta
Los eventos que han sido desencadenados por la solicitud.
Indica si estás solicitando una estimación de precio.
Obtener los eventos de tus acciones
Este endpoint te permite recuperar tus solicitudes y eventos de acciones más recientes.
Parámetros de consulta
La página a recuperar (por defecto es 1).
1
El número de eventos que se devolverán (entre 1 y 25). Por defecto es 10.
10
El estado de los eventos a recuperar.
Valores posibles
El tipo de eventos a recuperar.
Valores posibles
Respuesta
La lista de eventos.
La información de metadatos.
Industries
Busca industrias específicas y obtén información como el número de empresas que contiene.
Buscar industrias
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
La página a recuperar (por defecto 1).
/industries?page=1
Una consulta de búsqueda adicional aplicada al nombre de la industria.
/industries?search=saas
El número de industrias a devolver (entre 1 y 100). Por defecto 25.
/industries?size=10
Respuesta
Las industrias que coinciden con tus criterios.
La información de metadatos.
Buscar industrias similares
Descubre industrias similares con nuestra API. Identifica sectores relacionados y amplía tus oportunidades comerciales.
Parámetros de consulta
Las industrias para comparar (máx. 10).
/industries/similar?industries[]=saas&industries[]=fintech
La página a recuperar (por defecto 1).
/industries/similar?page=1
El número de industrias a devolver (entre 1 y 100). Por defecto a 25.
/industries/similar?size=10
Respuesta
Las industrias que coinciden con tus criterios.
La información de metadatos.
Tecnologías
Actualmente rastreamos 368 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.
Buscar tecnologías
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
La página a recuperar (por defecto 1).
/technologies?page=1
Una consulta de búsqueda adicional aplicada al nombre de la tecnología.
/technologies?search=shopify
El número de tecnologías a devolver (entre 1 y 100). Por defecto 25.
/technologies?size=10
Respuesta
Las tecnologías que identificamos que coinciden con tus condiciones.
La información de metadatos.
Localizaciones
Los siguientes endpoints te permiten buscar todas nuestras localizaciones: ciudades, condados, estados, países y continentes.
Buscar ciudades
Busca nuestras ciudades para filtrar empresas en una ubicación específica.
Parámetros de consulta
La página a obtener (por defecto 1).
Una consulta de búsqueda adicional aplicada al nombre de la ciudad.
El número de ciudades a devolver (entre 1 y 20). Por defecto 10.
Respuesta
Las ciudades que coinciden con tus condiciones.
La información de metadatos.
Buscar departamentos
Busca en nuestra base de datos de departamentos para filtrar empresas en un lugar específico.
Parámetros de consulta
La página a recuperar (por defecto 1).
Una consulta de búsqueda adicional aplicada al nombre del departamento.
El número de departamentos a devolver (entre 1 y 20). Por defecto 10.
Respuesta
Los departamentos que coinciden con tus criterios.
La información de metadatos.
Buscar estados
Busca en nuestra base de datos de estados para filtrar empresas en un lugar específico.
Parámetros de consulta
La página a recuperar (por defecto 1).
Una consulta de búsqueda adicional aplicada al nombre del estado.
El número de estados a devolver (entre 1 y 20). Por defecto 10.
Respuesta
Los estados que coinciden con tus criterios.
La información de metadatos.
Buscar países
Busca en nuestra base de datos de países para filtrar empresas en un lugar específico.
Parámetros de consulta
La página a recuperar (por defecto 1).
Una consulta de búsqueda adicional aplicada al nombre del país.
El número de países a devolver (entre 1 y 20). Por defecto 10.
Respuesta
Los países que coinciden con tus criterios.
La información de metadatos.
Buscar continentes
Busca en nuestros continentes para filtrar empresas en una ubicación específica.
Parámetros de consulta
La página que se va a buscar (por defecto 1).
Una consulta de búsqueda adicional aplicada al nombre del continente.
La cantidad de continentes que se devolverán (entre 1 y 20). Por defecto 10.
Respuesta
Los continentes que coinciden con tus condiciones.
La información de metadatos.
Profesiones
Encuentra profesiones específicas y obtén información como el número de empresas que contiene.
Enriquecer una profesión a partir de su nombre
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
El nombre de la profesión.
/job-titles/enrich?name=chief%20executive%20officer
Respuesta
The job title's department.
marketing
Valores posibles
The job title's secondary department.
content marketing
Valores posibles
The job title's english name.