Playground
Essaie chaque requête dans le navigateur et copie le code.
Dans l’API Playground, tu essaies n’importe quelle requête dans le navigateur, sans code. Tu vois la vraie réponse de l’API et copies ensuite la requête sous forme de code.
Requêtes sans code
Le Playground nécessite un compte avec une adresse e-mail confirmée. Il a un onglet par endpoint :
| Onglet | Endpoint | Ce que tu essaies |
|---|---|---|
| Profil d’entreprise | fetch-organization | Données de base, fonctionnalités, mode IA et mode temps réel |
| Profil de personne | fetch-person | Fonctions et participations d’une personne, à partir de Plus |
| Documents | fetch-document | Extraits du registre, listes des associés et statuts |
| Recherche & Export | search-organizations | Recherche avec filtres et export sous forme de fichier |
| Signals | signals | Modifications au registre par thème et période |
À gauche, tu construis la requête. Chaque champ est un paramètre de l’API et affiche son vrai nom, par exemple q, feature ou ai_search=on-default.
À droite se trouve la réponse. « Affichage » la montre mise en forme, « JSON » exactement comme l’API la renvoie, erreurs comprises.
Copier le code
Au-dessus de la réponse se trouve la requête avec sa méthode et son URL complète. Un clic sur « Code » l’ouvre sous forme d’exemple en cURL, Python, JavaScript et PHP, pour le profil de personne en cURL, Python et JavaScript.
Les exemples utilisent du HTTP simple et l’espace réservé YOUR_API_KEY. Remplace-le par ta clé API de Compte › Clés API.
Exporter des listes d’entreprises
Dans l’onglet Recherche & Export, tu télécharges toute une liste de résultats sous forme de fichier, en CSV, Excel ou JSON. Un export couvre jusqu’à 5 000 entreprises.
Tu vois les coûts avant de démarrer. Le prix de base de 50 crédits inclut les 17 premières pages de 30 entreprises chacune ; chaque page supplémentaire coûte 6 crédits.
L’export continue en arrière-plan, même si tu quittes la page. Tu trouves ensuite le fichier sous Compte › Exports.
Un export ne lit les résultats qu’au moment de son exécution, les modifications jusque-là sont donc incluses. Par défaut, il omet les entreprises sans adresse publiée ; tu peux le changer avant de démarrer.
Via l’API, tu parcours les mêmes résultats avec skip et limit, voir Constituer des listes d’entreprises.