The Companies API LogoThe Companies API Logo
APICas d'usagesEntreprises
S'identifierS'identifier
Commencer
Authentification
Erreurs
Limites de débit
Webhooks
Datapoints (entreprise)
Entreprises
Enrichir depuis domaine
Enrichir depuis email
Enrichir depuis réseau social
Compter entreprises
Rechercher entreprises
Rechercher par nom
Rechercher par prompt
Rechercher similaires
Demander entreprise
Récupérer contexte
Trouver modèles email
Récupérer analytiques
Exporter analytiques
Industries
Rechercher industries
Trouver industries similaires
Listes
Récupérer listes
Créer liste
Récupérer entreprises
Basculer entreprises
Emplacements
Rechercher villes
Rechercher comtés
Rechercher pays
Rechercher états
Rechercher continents
Actions
Demander action
Récupérer actions
Équipes
Récupérer équipe
Technologies
Rechercher technologies
Utilitaires
Santé API
Spécification OpenAPI
Commencer
Authentification
Erreurs
Limites de débit
Webhooks
Datapoints (entreprise)
Entreprises
Enrichir depuis domaine
Enrichir depuis email
Enrichir depuis réseau social
Compter entreprises
Rechercher entreprises
Rechercher par nom
Rechercher par prompt
Rechercher similaires
Demander entreprise
Récupérer contexte
Trouver modèles email
Récupérer analytiques
Exporter analytiques
Industries
Rechercher industries
Trouver industries similaires
Listes
Récupérer listes
Créer liste
Récupérer entreprises
Basculer entreprises
Emplacements
Rechercher villes
Rechercher comtés
Rechercher pays
Rechercher états
Rechercher continents
Actions
Demander action
Récupérer actions
Équipes
Récupérer équipe
Technologies
Rechercher technologies
Utilitaires
Santé API
Spécification OpenAPI

Récupérer les entreprises de votre liste

Récupérez les entreprises stockées dans vos listes.
GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies
Gratuit

Les entreprises dans vos listes peuvent être récupérées page par page avec page et size.

Vous pouvez également les trier avec sortKey et sortOrder.

Pour filtrer vos entreprises, vous pouvez utiliser le paramètre query.

Inscrivez-vous pour accéder à toutes les fonctionnalités de notre API

Recevez vos 500 crédits gratuits et commencez à enrichir et rechercher des entreprises.

Aucune carte de crédit requise

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&token=XXXXXX
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
Afficher 13 autres
sortOrderstring (optionnel)

L'ordre pour trier les résultats.

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

Valeurs possibles

asc
desc
Schéma de réponse
companiesarray

Les entreprises qui appartiennent à votre liste.

Parcourir tous les points de données
metaobject

Les informations sur les métas.

Exemples de code
Sélectionnez votre langage favori :
C#

Go

Java

JavaScript
SDK

PHP

Python

Ruby

Rust

import createClient from '@thecompaniesapi/sdk'

const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })

const response = await tca.fetchCompaniesInList({
  listId: 1234
})

const companies = response.data.companies // Companies that match the list
const meta = response.data.meta // Meta information

Créer une liste d'entreprises

Créez une liste d'entreprises avec notre API.

Ajouter ou supprimer des entreprises dans votre liste

Ajoutez ou supprimez des entreprises dans vos listes en utilisant leurs noms de domaine ou leurs IDs.

Une image de fond lumineuse pour mettre en avant le titreUne image de fond lumineuse pour mettre en avant le titre
© 2025 The Companies API
  • Mises à jour
  • Conditions
  • Confidentialité
  • FAQ
  • Statut

Entreprises SaaS à croissance rapide avec des équipes à distance