Cómo construir un buscador de empresas con nuestra API
Aprende a crear un potente buscador de empresas utilizando nuestra API. Esta guía cubre el uso de endpoints, técnicas de segmentación y filtrado, incluyendo ejemplos de código y detalles de precios.
¿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 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.
Cognizantcognizant.com | 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 | Teaneck Township Bergen County, New Jersey | 1994 |    | --- | --- | Alto (105) | hace 3 meses | |||
Ciscocisco.com | 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 | San Jose Santa Clara County, California | 1984 |      | --- | --- | Alto (102) | hace 2 meses | |||
Jabiljabil.com | 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 | Saint Petersburg Pinellas County, Florida | 1992 |     +1 | --- | --- | Alto (98) | hace 3 meses | |||
Vestasvestas.com | Más de 10,000 empleados | Más de $1 billón | Empresa Pública | 10M - 50M | Dinamarca Europa | Aarhus Central Denmark Region | 1945 |  | --- | --- | Alto (98) | hace 3 meses | |||
Boeingboeing.com | Más de 10,000 empleados | $50 millones - $100 millones | Empresa Pública | Más de 1 billón | Estados Unidos América del Norte | Chicago Cook County, Illinois | 1916 | | --- | --- | Alto (97) | hace 3 meses |
Nuestro endpoint de búsqueda de empresas
proporciona potentes capacidades de búsqueda a través de una simple peticiónGET. 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.
El parámetro query para el endpoint
- 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
andpara requerir que todos los valores sean verdaderos, oorpara 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 atributoabout.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.
Antes de usar The Companies API, necesitarás un token de API. Asegúrate de leer nuestra documentación para autenticar correctamente tus solicitudes.
Selecciona o crea un token
Aquí hay ejemplos de código en varios lenguajes para ayudarte a empezar a construir tu propio buscador de empresas.
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)
¿Necesitas ayuda para implementar tu caso de uso?
¡Contáctanos a través del chat de abajo y lo solucionamos juntos!