Cómo construir un buscador de empresas con nuestra API

Introducción

¿Quieres construir un potente buscador de empresas como el que ofrecemos? Nuestra API lo hace simple. En esta guía, aprenderás:

Cómo usar el endpoint
Buscar empresas con criterios
para obtener potentes capacidades de búsqueda.
Cómo funciona nuestro sistema de segmentación para filtrar nuestra base de datos.
Qué atributos de empresa puedes buscar y filtrar.
Ejemplos de código en varios lenguajes para empezar.
Detalles de precios y uso.


Lockheed Martinlockheedmartin.com	defense and space manufacturing aerospace defense technology military and international affairs space research and technology cyber security security systems services space exploration engineering services	Más de 10,000 empleados	Más de $1 billón	Empresa Pública	Más de 1 billón	Estados Unidos América del Norte	Irvine Orange County, California	1912	---	---	Alto (96)	hace 5 meses
Berry Globalberryglobal.com	plastics manufacturing blow molding blown film cast film chemicals compression molding extruded tubes injection molding laminate tubes nonwoven	Más de 10,000 empleados	Más de $1 billón	Empresa Pública	10M - 50M	Estados Unidos América del Norte	Evansville Vanderburgh County, Indiana	1967	---	---	Alto (94)	hace 7 meses
RR Donnelleyrrd.com	marketing services packaging solutions print services supply chain solutions retail consumer services cannabis and cbd grocery quick serve restaurants education	Más de 10,000 empleados	Más de $1 billón	Empresa Pública	10M - 50M	Estados Unidos América del Norte	Chicago Cook County, Illinois	1864	---	---	Alto (94)	hace 5 meses
Viatrisviatris.com	pharmaceutical manufacturing healthcare medical equipment manufacturing medical practices medical and diagnostic laboratories research services manufacturing it services and it consulting it system data services it system design services	Más de 10,000 empleados	Más de $1 billón	Empresa Pública	10M - 50M	Alemania Europa	Bad Homburg vor der Höhe Hochtaunuskreis, Hesse	1968	---	---	Alto (93)	hace 5 meses
British American Tobaccobat.com	tobacco manufacturing consumer goods rental retail wholesale wholesale alcoholic beverages wholesale luxury goods and jewelry consumer services e commerce insurance health and human services	Más de 10,000 empleados	Más de $1 billón	Empresa Pública	Más de 1 billón	Reino Unido Europa	London England	1902	---	---	Alto (93)	hace 5 meses

Cómo funciona

Nuestro endpoint de búsqueda de empresas

Buscar empresas con criterios

proporciona potentes capacidades de búsqueda a través de una simple petición GET. Devuelve un número personalizable de empresas coincidentes según tus criterios de búsqueda.

También puedes navegar fácilmente entre las páginas de resultados, ordenar las empresas según cualquier atributo y combinar múltiples filtros entre ellos.

Cada empresa devuelta en la respuesta completa cuesta 1 crédito. Puedes explorar nuestros planes de precios completos para encontrar la mejor opción para tus necesidades.

Utiliza el parámetro simplified=true para obtener una versión ligera de los datos de la empresa. Las respuestas simplificadas son gratuitas y no consumen créditos. Son perfectas para mostrar vistas previas o listas de resultados de búsqueda.

GET

https://api.thecompaniesapi.com/v2/companies

El parámetro query para el endpoint

Buscar empresas con criterios

es un array de condiciones. Cada condición es un objeto con las siguientes propiedades:

attribute: El atributo por el que deseas filtrar (por ejemplo, about.industries, about.totalEmployees, finances.revenue). Consulta la documentación del endpoint de la API para ver la lista completa de atributos disponibles.
operator: Operador lógico para combinar los valores. Usa and para requerir que todos los valores sean verdaderos, o or para requerir que al menos un valor sea verdadero.
sign: El signo de comparación para la condición. Las opciones incluyen:
- equals: Coincide si el valor especificado está incluido en el valor del atributo.
- exactEquals: Coincide si el valor especificado coincide exactamente con el valor del atributo.
- notEquals: Coincide si el valor especificado no está incluido en el valor del atributo.
values: Un array de valores para comparar con el atributo (por ejemplo, ["saas", "software"] para el atributo about.industries).

Un ejemplo vale más que mil palabras:

[
  // Coincide con empresas que están tanto en la industria SaaS COMO en software
  {
    "attribute": "about.industries",
    "operator": "and",
    "sign": "equals",
    "values": ["saas", "software"]
  },
  // Coincide con empresas con ingresos que NO están en el rango de 50m-100m
  {
    "attribute": "finances.revenue",
    "operator": "or",
    "sign": "notEquals",
    "values": ["50m-100m"]
  }
]

Esta query debe convertirse en una cadena de caracteres y codificarse en formato URL antes de ser utilizada en el parámetro query del endpoint.

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%5D&token=XXXXXX

El endpoint que define tus criterios de búsqueda.

Tokens de API

Antes de usar The Companies API, necesitarás un token de API. Asegúrate de leer nuestra documentación para autenticar correctamente tus solicitudes.

Parece que no tienes ningún token API todavía. Puedes crear uno en el siguiente bloque.

Selecciona o crea un token

Ejemplos de código

Aquí hay ejemplos de código en varios lenguajes para ayudarte a empezar a construir tu propio buscador de empresas.

Selecciona tu lenguaje favorito:

JavaScript

PHP

Python

async function searchCompanies(query, page = 1, size = 25) {
  const baseUrl = 'https://api.thecompaniesapi.com/v2/companies';

  const params = new URLSearchParams({
    query: JSON.stringify(query),
    page,
    size
  });

  const url = `${baseUrl}?${params.toString()}`;

  const response = await fetch(url, {
    headers: {
      Authorization: `Basic ${process.env.YOUR_API_TOKEN}`,
    },
  });

  if (!response.ok) {
    throw new Error(`API request failed: ${response.status}`);
  }

  return await response.json();
}

// Retrieve SaaS companies with revenue between 50m and 100m
const query = [
  { "attribute": "about.industries", "operator": "and", "sign": "equals", "values": ["saas"] },
  { "attribute": "finances.revenue", "operator": "or", "sign": "notEquals", "values": ["50m-100m"] }
]

await searchCompanies(query)

Cómo construir un buscador de empresas con nuestra API

¿Necesitas ayuda para implementar tu caso de uso?