Comment construire un moteur de recherche d'entreprises avec notre API
Apprenez à créer un puissant moteur de recherche d'entreprises en utilisant notre API. Ce guide couvre l'utilisation des endpoints, les techniques de segmentation et de filtrage, avec des exemples de code et des détails sur les tarifs.
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 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.
Viatrisviatris.com | 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 7 mois | |||
Ciscocisco.com | Plus de 10,000 employés | Au dessus de $1 milliard | Entreprise publique | Au dessus de 1 milliard | États-Unis Amérique du Nord | San Jose Santa Clara County, California | 1984 | --- | --- | --- | Élevé (93) | il y a 13 jours | |||
Jabiljabil.com | Plus de 10,000 employés | Au dessus de $1 milliard | Entreprise publique | Au dessus de 1 milliard | États-Unis Amérique du Nord | Farmington Hills Oakland County, Michigan | 1992 |       +1 | --- | --- | Élevé (92) | il y a 2 mois | |||
Trimbletrimble.com | 5,000 à 10,000 employés | Au dessus de $1 milliard | Entreprise publique | 10M - 50M | États-Unis Amérique du Nord | Sunnyvale Santa Clara County, California | 1981 |      +3 | --- | --- | Élevé (91) | il y a 7 mois | |||
Whirlpoolwhirlpoolcorp.com | Plus de 10,000 employés | Au dessus de $1 milliard | Entreprise publique | 10M - 50M | États-Unis Amérique du Nord | Benton Harbor Berrien County, Michigan | 1911 |     | --- | --- | Élevé (91) | il y a 7 mois |
Notre endpoint de recherche d'entreprises
offre de puissantes capacités de recherche via une simple requêteGET. 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.
Le paramètre query pour le endpoint
- 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
andpour exiger que toutes les valeurs soient vraies, ouorpour 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'attributabout.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.
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
Voici des exemples de code dans différents langages pour vous aider à démarrer la construction de votre propre moteur de recherche d'entreprises.
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)
Besoin d'aide pour implémenter votre cas d'utilisation ?
Contactez-nous via le chat ci-dessous, et trouvons la solution ensemble !