Comment construire votre moteur de recherche d'entreprises

Introduction

Vous voulez construire un puissant moteur de recherche d'entreprises comme celui que nous proposons ? Notre API rend cela simple. Dans ce guide, vous apprendrez :

Comment utiliser l'endpoint
Rechercher des entreprises
pour des capacités de recherche puissantes.
Comment fonctionne notre système de segmentation pour filtrer notre base de données.
Quels attributs d'entreprise vous pouvez rechercher et filtrer.
Des exemples de code dans plusieurs langages pour commencer.
Les détails des prix et de l'utilisation.


Microsoftmicrosoft.com	software development advertising business software cloud computing collaboration computer games computer software computers consumer electronics consumer internet	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	Au dessus de 1 milliard	États-Unis Amérique du Nord	Redmond King County, Washington	1975			---	---	il y a 5 jours	Élevé (102)
PayPalpaypal.com	internet accountants banks computer software consumer internet consumers credit unions databases e commerce e commerce platforms	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise privée	Au dessus de 1 milliard	États-Unis Amérique du Nord	San Jose Santa Clara County, California	1998		---	---	---	il y a 24 jours	Élevé (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	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise privée	100M - 500M	États-Unis Amérique du Nord	Teaneck Township Bergen County, New Jersey	1994		---	---	---	il y a 20 jours	Élevé (98)
Walmartwalmart.com	retail computer software consumer internet consumers department stores drugstores e commerce ecommerce enterprise software enterprises	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise privée	Au dessus de 1 milliard	États-Unis Amérique du Nord	Bentonville Benton County, Arkansas	1962		---		---	il y a 14 jours	Élevé (97)
Nikenike.com	sporting goods manufacturing apparel athletic shoes consumer goods consumers digital fabricated rubber products fashion innovation merchandising	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	Au dessus de 1 milliard	États-Unis Amérique du Nord	Beaverton Washington County, Oregon	1964	+5	---	---	---	il y a 5 jours	Élevé (96)

Jeton API

Avant d'utiliser The Companies API, vous aurez besoin d'un jeton API. Assurez-vous de lire notre documentation pour authentifier correctement vos requêtes.

Il semble que vous n'ayez pas encore de jetons API. Vous pouvez créer un jeton dans le bloc suivant.

Sélectionner ou créer un jeton

Comment ça fonctionne

Notre endpoint de recherche d'entreprises

Rechercher des entreprises

offre de puissantes capacités de recherche via une simple requête GET. Il renvoie un nombre personnalisable d'entreprises correspondant à vos critères de recherche.

Vous pouvez également naviguer facilement entre les pages de résultats, trier les entreprises selon n'importe quel attribut et combiner plusieurs filtres entre-eux.

Chaque entreprise retournée dans la réponse complète coûte 1 crédit. Vous pouvez consulter nos plans tarifaires complets pour trouver la meilleure option adaptée à vos besoins.

Utilisez le paramètre simplified=true pour obtenir une version allégée des données d'entreprise. Les réponses simplifiées sont gratuites et ne consomment aucun crédit. Elles sont parfaites pour afficher des aperçus ou des listes de résultats de recherche.

GET

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

Notre système de segmentation

Le paramètre query pour le endpoint

Rechercher des entreprises

est un tableau de conditions. Chaque condition est un objet avec les propriétés suivantes :

attribute: L'attribut par lequel vous souhaitez filtrer (par exemple, about.industries, about.totalEmployees, finances.revenue). Consultez la documentation de l'endpoint de l'API pour la liste complète des attributs disponibles.
operator: Opérateur logique pour combiner les valeurs. Utilisez and pour exiger que toutes les valeurs soient vraies, ou or pour exiger qu'au moins une valeur soit vraie.
sign: Le signe de comparaison pour la condition. Les options incluent :
- equals: Correspond si la valeur spécifiée est incluse dans la valeur de l'attribut.
- exactEquals: Correspond si la valeur spécifiée correspond exactement à la valeur de l'attribut.
- notEquals: Correspond si la valeur spécifiée n'est pas incluse dans la valeur de l'attribut.
values: Un tableau de valeurs à comparer avec l'attribut (par exemple, ["saas", "software"] pour l'attribut about.industries).

Un exemple vaut mille mots :

[
  // Correspond aux entreprises dans les industries SaaS ET logiciel
  {
    "attribute": "about.industries",
    "operator": "and",
    "sign": "equals",
    "values": ["saas", "software"]
  },
  // Correspond aux entreprises dont le revenu N'EST PAS dans la plage de 50m-100m
  {
    "attribute": "finances.revenue",
    "operator": "or",
    "sign": "notEquals",
    "values": ["50m-100m"]
  }
]

Cette query doit être convertie en chaîne de caractères et encodée au format URL avant d'être utilisée dans le paramètre query de l'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

L'endpoint qui définit vos critères de recherche.

Exemples de code

Voici des exemples de code dans différents langages pour vous aider à démarrer la construction de votre propre moteur de recherche d'entreprises.

Sélectionnez votre langage favori :

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)

Comment construire votre moteur de recherche d'entreprises

Besoin d'aide pour implémenter votre cas d'utilisation ?