Cómo construir tu buscador de empresas

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
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.


Microsoftmicrosoft.com	software development advertising business software cloud computing collaboration computer games computer software computers consumer electronics consumer internet	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	Redmond King County, Washington	1975			---	---	hace 4 días	Alto (102)
PayPalpaypal.com	internet accountants banks computer software consumer internet consumers credit unions databases e commerce e commerce platforms	Más de 10,000 empleados	Más de $1 billón	Empresa Privada	Más de 1 billón	Estados Unidos América del Norte	San Jose Santa Clara County, California	1998		---	---	---	hace 23 días	Alto (101)
Cognizantcognizant.com	information technology and services analytics information management analytics services application services bi business process outsourcing business process services cloud cloud solutions computer software	Más de 10,000 empleados	Más de $1 billón	Empresa Privada	100M - 500M	Estados Unidos América del Norte	Teaneck Township Bergen County, New Jersey	1994		---	---	---	hace 19 días	Alto (98)
Walmartwalmart.com	retail computer software consumer internet consumers department stores drugstores e commerce ecommerce enterprise software enterprises	Más de 10,000 empleados	Más de $1 billón	Empresa Privada	Más de 1 billón	Estados Unidos América del Norte	Bentonville Benton County, Arkansas	1962		---		---	hace 13 días	Alto (97)
Nikenike.com	sporting goods manufacturing apparel athletic shoes consumer goods consumers digital fabricated rubber products fashion innovation merchandising	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	Beaverton Washington County, Oregon	1964	+5	---	---	---	hace 4 días	Alto (96)

Token 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

Cómo funciona

Nuestro endpoint de búsqueda de empresas

Buscar empresas

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

Nuestro sistema de segmentación

El parámetro query para el endpoint

Buscar empresas

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

El endpoint que define tus criterios de búsqueda.

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:

Java

JavaScript

SDK

PHP

Python

Ruby

Rust

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 tu buscador de empresas

¿Necesitas ayuda para implementar tu caso de uso?