Comment construire un moteur de recherche d'entreprises avec notre API

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 par critères
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.


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	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	Au dessus de 1 milliard	États-Unis Amérique du Nord	Irvine Orange County, California	1912	---	---	Élevé (96)	il y a 5 mois
Berry Globalberryglobal.com	plastics manufacturing blow molding blown film cast film chemicals compression molding extruded tubes injection molding laminate tubes nonwoven	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	10M - 50M	États-Unis Amérique du Nord	Evansville Vanderburgh County, Indiana	1967	---	---	Élevé (94)	il y a 7 mois
RR Donnelleyrrd.com	marketing services packaging solutions print services supply chain solutions retail consumer services cannabis and cbd grocery quick serve restaurants education	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	10M - 50M	États-Unis Amérique du Nord	Chicago Cook County, Illinois	1864	---	---	Élevé (94)	il y a 5 mois
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	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	10M - 50M	Allemagne Europe	Bad Homburg vor der Höhe Hochtaunuskreis, Hesse	1968	---	---	Élevé (93)	il y a 5 mois
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	Plus de 10,000 employés	Au dessus de $1 milliard	Entreprise publique	Au dessus de 1 milliard	Royaume-Uni Europe	London England	1902	---	---	Élevé (93)	il y a 5 mois

Comment ça marche

Notre endpoint de recherche d'entreprises

Rechercher des entreprises par critères

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

Le paramètre query pour le endpoint

Rechercher des entreprises par critères

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

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

Jetons 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

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 :

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)

Comment construire un moteur de recherche d'entreprises avec notre API

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