Une API de données entreprises pour chercher et débloquer les commerces depuis vos outils
Cherchez des commerces par métier, ville, note ou coordonnées disponibles, puis récupérez leurs emails et téléphones depuis votre CRM, vos scripts ou vos agents IA. Mêmes données et mêmes crédits que sur le site.
- 25 crédits offerts
- Sans abonnement
- CRM d'équipe inclus
Une API de données entreprises sert à interroger une base de sociétés depuis vos propres outils, sans passer par une interface ni par des exports à la main. L’API de Prospya donne accès aux commerces locaux de France et de Belgique : vous cherchez gratuitement par métier, ville, région, note ou coordonnées disponibles, puis vous débloquez les fiches qui vous intéressent pour récupérer téléphone, email, site et Instagram, avec les mêmes crédits que sur le site.
Pourquoi une API de base de données entreprises
Exporter un CSV de temps en temps suffit pour une campagne ponctuelle. Dès que la prospection devient un processus, les copier-coller deviennent le goulot d’étranglement : un commercial qui doit sortir de son CRM pour chercher des prospects, un script de qualification qui attend un fichier, une équipe marketing qui veut des listes fraîches chaque semaine. Une API de prospection règle ce problème : votre outil pose la question, la base répond en JSON.
Les API de données d’entreprises les plus connues reposent sur les registres officiels (numéro d’immatriculation, dirigeants, chiffre d’affaires) ou sur des profils professionnels de cadres. Elles conviennent pour vendre à des sièges sociaux. Pour vendre à une boulangerie, un salon de coiffure ou un garage, il faut autre chose : le téléphone et l’email que le commerce publie, son site, son Instagram, sa note Google et son nombre d’avis. C’est ce que renvoie l’API de Prospya.
Chiffres calculés en direct sur la base, mis à jour automatiquement.
Ce que fait l’API données entreprises de Prospya
Les mêmes filtres que le site : métier, ville, région, note, avis, téléphone, email, site, Instagram, ou une phrase libre.
Jusqu’à 500 fiches par appel, 1 crédit par commerce avec un téléphone ou un email.
Le solde est partagé avec votre compte et votre équipe ; une fiche déjà débloquée ne coûte plus rien.
Une clé créée dans votre compte, envoyée dans l’en-tête de chaque requête.
Les fiches débloquées par l’API arrivent dans Mes contacts, comme celles du site.
Réponses JSON simples, faciles à brancher dans un script, un outil no-code ou un agent IA.
Les trois points d’entrée
L’API compte trois points d’entrée, documentés sur la page API :
| Point d’entrée | Rôle | Coût |
|---|---|---|
| GET /api/v1/me | Votre email et votre solde de crédits | Gratuit |
| GET /api/v1/search | Recherche de commerces, 25 résultats par page | Gratuit |
| POST /api/v1/unlock | Déblocage de fiches par identifiant, jusqu’à 500 par appel | 1 crédit par commerce avec téléphone ou email |
Il n’y a pas d’autre point d’entrée caché, et pas d’abonnement à l’API : vous utilisez simplement vos crédits.
Rechercher : les mêmes filtres que sur le site
La recherche accepte category (métier), city, region, has_phone=1, has_email=1, has_instagram=1, has_website=0 ou 1, rating_min, reviews_min, reviews_max et page. Le paramètre q accepte aussi une phrase libre, comme « plombiers à Lyon sans site ». Les résultats indiquent le nom, le métier, l’adresse, le code postal, la ville, la région, le pays, la note, le nombre d’avis et la présence de chaque coordonnée, mais pas les coordonnées elles-mêmes tant que la fiche n’est pas débloquée.
GET /api/v1/search?category=plumber
&city=Lyon&has_email=1
Authorization: Bearer ld_votre_cle
La réponse donne le nombre total de résultats, la page et la liste des fiches, chacune avec son identifiant et un champ unlocked.
Débloquer : téléphone, email, site et Instagram
Pour récupérer les coordonnées, envoyez la liste des identifiants à débloquer. Chaque commerce avec un téléphone ou un email coûte un crédit ; les fiches sans aucune des deux sont gratuites, et une fiche déjà débloquée par vous ou votre équipe ne coûte jamais deux fois.
POST /api/v1/unlock
Content-Type: application/json
{"ids": [1042, 1043]}
La réponse indique les crédits dépensés, le solde restant et les fiches complètes : téléphone, email, site et Instagram en plus des champs de la recherche. Les erreurs sont explicites : 401 pour une clé invalide, 402 quand les crédits manquent, 400 sans identifiant, 403 quand le plafond mensuel d’un membre de l’équipe est atteint.
Une API de prospection pour vos outils et vos agents IA
Depuis votre CRM ou un outil no-code
Un commercial ajoute une ville et un métier dans votre CRM ; un scénario no-code appelle la recherche, filtre les commerces bien notés avec un email, débloque les vingt premiers et crée les contacts. Ou, chaque lundi, un script récupère les nouveaux commerces d’une région pour alimenter une campagne. L’export CSV reste disponible pour HubSpot, Pipedrive, Brevo ou Lemlist si vous préférez l’import manuel.
Des données commerces pour agents IA
Les assistants et agents IA qui savent appeler des outils peuvent utiliser l’API directement : un point d’entrée pour chercher, un pour débloquer, un pour vérifier le solde. Vous décrivez les trois appels à votre agent, avec la clé, et il peut répondre à une demande comme « trouve 30 salons de coiffure à Nantes avec un email et une bonne note » en cherchant d’abord gratuitement, puis en débloquant seulement les fiches retenues. Fixez une règle simple pour l’agent (un nombre maximal de déblocages par tâche) et, si vous travaillez en équipe, un plafond mensuel de crédits pour le membre qui porte la clé.
Pour enrichir des fichiers en continu
Si votre besoin est de compléter une liste que vous avez déjà (téléphones, emails ou sites), la fonction Compléter un fichier le fait sans code, jusqu’à 5 000 lignes par envoi : voir l’enrichissement de fichier B2B. L’API sert plutôt à chercher de nouveaux commerces et à les débloquer de façon automatique.
Ce que l’API ne renvoie pas
La base décrit des commerces, pas des personnes : pas de noms de gérants, pas de numéros personnels, pas de données financières, et la couverture se limite à la France et à la Belgique. Si vous avez besoin de données de registre ou de profils de dirigeants, une API fondée sur le registre du commerce ou un fournisseur de données sur les personnes conviendra mieux ; notre comparatif des alternatives à Apollo et Kaspr explique la différence.
Démarrer avec l’API en trois étapes
- 1Créez votre clé
Inscrivez-vous, puis ouvrez Compte, API et créez une clé. Elle n’est affichée qu’une fois : gardez-la dans un gestionnaire de secrets.
- 2Cherchez gratuitement
Appelez la recherche avec vos filtres, vérifiez le nombre de résultats et choisissez les fiches à débloquer.
- 3Débloquez et branchez
Envoyez les identifiants retenus, récupérez les coordonnées en JSON et poussez-les dans votre CRM, votre tableur ou votre agent.
Exemple illustratif : un éditeur fictif de logiciel de réservation, Tablio, lance chaque lundi un script qui cherche les restaurants de trois villes avec un email et au moins 4 étoiles, garde ceux qui ne sont pas encore débloqués, en débloque 100 et les ajoute à son CRM avec une étape « À contacter ». Ses commerciaux appellent depuis le CRM ; la recherche, elle, ne coûte rien. Les volumes réels dépendent de votre cible.
Les bonnes pratiques
- Cherchez avant de débloquer : la recherche est gratuite, utilisez-la pour compter et filtrer, puis ne débloquez que les fiches utiles.
- Gardez les identifiants côté outil : une fiche déjà débloquée revient gratuitement, mais un cache local évite des appels inutiles.
- Ne mettez jamais la clé dans un navigateur ou un dépôt de code public. Une réinitialisation du mot de passe du compte révoque la clé.
- Respectez les règles de prospection : identifiez-vous, proposez une désinscription, tenez une liste de commerces à ne plus contacter. Notre guide RGPD et prospection B2B résume l’essentiel ; ce n’est pas un conseil juridique.
Prix de l’API données entreprises
L’API n’a pas de tarif à part : la recherche et le solde sont gratuits, et chaque commerce débloqué avec un téléphone ou un email coûte un crédit, comme sur le site. Packs : 9 € pour 250 crédits, 49 € pour 2 000, 149 € pour 10 000, sans abonnement, et les crédits n’expirent pas. 25 crédits sont offerts à l’inscription, sans carte bancaire, de quoi tester vos premiers appels. Pour des volumes plus importants, contactez-nous. Voir aussi les tarifs.
| Usage | Exemple de volume | Pack adapté |
|---|---|---|
| Test d’intégration | Quelques dizaines de fiches | Crédits offerts à l’inscription |
| Flux hebdomadaire d’une ville | 200 fiches par mois | 9 € pour 250 crédits |
| Plusieurs villes ou métiers | 1 000 à 2 000 fiches | 49 € pour 2 000 crédits |
| Équipe ou agence | Jusqu’à 10 000 fiches | 149 € pour 10 000 crédits |
Pour comprendre la base derrière l’API, lisez la page base de données entreprises ; pour suivre les prospects débloqués, le CRM prospection ; pour les appeler, le logiciel de prospection téléphonique. Pages par cible : éditeurs de logiciels et agences marketing.
Les guides pour vous
Comment trouver des clients : les méthodes qui marchent en B2B, en freelance et auprès des commerces
Comment trouver des clients en B2B ou en freelance : définir votre cible, choisir les bons canaux, contacter vos premiers prospects, tenir un plan de 30 jours.
Lire Guide · 8 min de lectureProspection commerciale : les méthodes, les techniques et un plan de prospection prêt à suivre
Prospection commerciale : définir la cible, construire un plan de prospection, choisir les techniques par canal, écrire le message, suivre les bons indicateurs.
Lire Article · 7 min de lectureQu'est-ce qu'un lead ? Définition simple, lead qualifié, MQL, SQL et lead B2B
Qu'est-ce qu'un lead ? Définition simple, différence avec un prospect, lead qualifié, MQL et SQL, et ce que cela change quand on vend aux commerces locaux.
LireExiste-t-il une API pour obtenir les coordonnées des entreprises ?
Oui. L’API de Prospya renvoie les commerces locaux de France et de Belgique par métier, ville ou région, avec leur téléphone, leur email, leur site et leur Instagram une fois débloqués. La recherche est gratuite ; chaque fiche avec un téléphone ou un email coûte un crédit, comme sur le site.
Quelle API utiliser pour la prospection B2B ?
Tout dépend de votre cible. Pour vendre à des grandes entreprises et à leurs dirigeants, une API fondée sur les registres ou sur des profils professionnels convient mieux. Pour vendre à des commerces, artisans, restaurants ou salons, une API qui renvoie leurs coordonnées publiques, comme celle de Prospya, est plus directe.
L’API de Prospya est-elle gratuite ?
La recherche et la consultation du solde sont gratuites. Seul le déblocage coûte : un crédit par commerce avec un téléphone ou un email, jamais facturé deux fois. Les 25 crédits offerts à l’inscription permettent de tester l’intégration sans carte bancaire, et il n’y a pas d’abonnement à l’API.
Comment s’authentifier à l’API ?
Créez une clé dans Compte, puis API, et envoyez-la dans l’en-tête Authorization de chaque requête, sous la forme « Bearer » suivie de la clé. Elle n’est affichée qu’une fois, et nous n’en gardons qu’une empreinte. Une réinitialisation du mot de passe du compte la révoque.
Peut-on utiliser l’API avec un agent IA ?
Oui. Un agent capable d’appeler des outils peut utiliser les trois points d’entrée : chercher gratuitement, débloquer les fiches retenues, vérifier le solde. Limitez le nombre de déblocages par tâche dans ses instructions et, en équipe, fixez un plafond mensuel de crédits pour le membre qui porte la clé.
Quelles limites a l’API ?
La recherche renvoie 25 résultats par page, jusqu’à la page 200, et le déblocage accepte jusqu’à 500 identifiants par appel. La base couvre la France et la Belgique, et décrit des commerces, pas des personnes : pas de noms de gérants. Pour des volumes plus importants, contactez-nous.
Les autres fonctionnalités de Prospya
Construisons ensemble votre première liste
Démo de 20 minutes, gratuite et sans engagement. Ou commencez seul avec 25 crédits offerts.