Récupérer les entreprises de vos listes avec notre API

Récupérez des informations détaillées sur les entreprises dans vos listes avec notre API. Gérez et mettez à jour vos données d'entreprise sans effort.

Récupérer les entreprises de votre liste

Ce endpoint vous permet de récupérer les entreprises de vos listes.

Paramètres de requête

pagenumber (optionnel)

La page à récupérer (par défaut 1).

/lists/:listId/companies?page=1

sizenumber (optionnel)

Le nombre d'entreprises à récupérer (entre 1 et 100). Par défaut 10.

/lists/:listId/companies?size=10

querystring (requis)

La requête pour filtrer les entreprises dans votre liste.

Assurez-vous que ce paramètre soir stringifié et encodé.

GET

https://api.thecompaniesapi.com/v2/lists/:listId/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%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D

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

sortFieldsstring (optionnel)

Un array de plusieurs champs combinés pour trier les résultats.

…/lists/:listId/companies?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D

Assurez-vous que ce paramètre soir stringifié et encodé.

sortKeystring (optionnel)

Le champ pour trier les résultats.

…/lists/:listId/companies?sortKey=meta.score

Valeurs possibles

about.businessType

about.industries

about.industry

about.name

about.totalEmployees

about.yearFounded

analytics.monthlyVisitors

apps

codes.naics

codes.sic

12 autres

sortOrderstring (optionnel)

L'ordre pour trier les résultats.

…/lists/:listId/companies?sortOrder=asc

Valeurs possibles

asc

desc

Réponse

companiesarray

Les entreprises qui appartiennent à votre liste.

Parcourir tous les points de données

metaobject

Les informations sur les métas.

Endpoint

GET

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