Skip to main content
Enrow utilise un système basé sur les crédits, et les crédits sont consommés lorsqu’un résultat est trouvé ou qu’une vérification est effectuée. Cette page explique comment les crédits sont facturés pour chaque endpoint, comment vérifier votre solde, comment gérer les paramètres de facturation et ce qui se passe lorsque les crédits sont épuisés.

​
Comment fonctionnent les crédits ?

Les crédits ne sont consommés que lorsque l’API renvoie un résultat ou termine une vérification : les recherches infructueuses qui ne trouvent rien ne coûtent pas de crédits, à deux exceptions près pour l’Email Finder (voir ci-dessous). Chaque fonctionnalité consomme des crédits à un taux différent :
Les crédits sont facturés de la même manière pour les opérations unitaires et groupées — par résultat individuel. Lancer une recherche d’emails groupée sur 1 000 noms coûte le même prix par email trouvé que 1 000 recherches unitaires.
Deux exceptions pour l’Email Finder : un compte dont le taux de succès reste anormalement bas paie, après un avertissement, 0,25 crédit par recherche sans résultat, et une recherche à partir d’une URL de profil LinkedIn coûte 0,25 crédit si aucun email n’est trouvé. Voir la FAQ ci-dessous.
Chaque requête qui consomme des crédits renvoie un champ credits_used dans sa réponse, ce qui vous permet de suivre la consommation par recherche. Consultez Trouver un email pour un exemple de réponse.

​
Comment vérifier mon solde de crédits ?

Interrogez l’endpoint du compte avec votre clé d’API dans l’en-tête x-api-key pour récupérer votre solde de crédits actuel. Aucun corps de requête n’est nécessaire — le compte est identifié à partir de la clé d’API.
Response
La réponse contient votre solde et vos webhooks enregistrés : Pour la référence complète de l’endpoint, consultez Infos du compte. Vous pouvez également visiter votre Tableau de bord pour consulter les détails d’utilisation et de facturation, ou consulter le guide d’Authentification pour comprendre le fonctionnement de l’en-tête x-api-key sur tous les endpoints.

​
Comment gérer les paramètres de facturation ?

Sur les forfaits payants, la section Facturation → Paramètres de l’application propose deux réglages qui maintiennent votre compte approvisionné en crédits et vous préviennent avant qu’ils ne soient épuisés :
Recharge automatiquement votre solde dès qu’il passe sous le seuil de crédits que vous avez défini (au moins 100 crédits). Choisissez l’un des deux modes :
  • Renouvellement anticipé : votre forfait est renouvelé immédiatement et démarre un nouveau cycle avec ses crédits. Disponible uniquement avec un abonnement actif.
  • Recharge à l’usage : un pack de crédits à l’usage est acheté, selon le volume à créditer que vous choisissez.
Si votre solde est déjà sous le seuil au moment où vous enregistrez, la recharge a lieu immédiatement.
Envoie un email à l’adresse de votre choix lorsque votre solde passe sous un montant donné. Vous pouvez aussi publier cette alerte dans un canal Slack ou Discord.

​
Que se passe-t-il lorsque les crédits sont épuisés ?

Lorsque votre solde de crédits atteint zéro, les requêtes API renvoient un statut HTTP 402. Les endpoints unitaires (recherche d’email/de numéro unitaire, vérification unitaire) renvoient :
Les endpoints groupés renvoient plutôt { "message": "..." }. Pour la liste complète des codes de statut et des formats de réponse, consultez Codes de statut et Gestion des erreurs.
Pour éviter toute interruption, activez la Protection du solde ou une Alerte crédits dans Facturation → Paramètres.

​
Quel forfait choisir ?

Rendez-vous sur enrow.io/pricing pour comparer les forfaits et trouver celui qui correspond à vos besoins. Des crédits à l’usage peuvent être ajoutés à n’importe quel forfait, manuellement ou automatiquement avec la Protection du solde.

​
FAQ

Non. Les crédits ne sont consommés que lorsqu’un email ou un numéro de téléphone est trouvé, ou lorsqu’une vérification est effectuée. Une recherche qui ne renvoie aucun résultat ne coûte pas de crédits. Une exception, prévue à l’article 8.6 de nos conditions générales : si moins de 12 % des recherches Email Finder d’un compte trouvent un email, sur au moins 10 000 recherches en 7 jours, nous prévenons le compte par email. Si le taux est toujours aussi bas 7 jours plus tard, chaque recherche Email Finder sans résultat coûte 0,25 crédit jusqu’à ce qu’il remonte. Autre exception : une recherche Email Finder à partir d’une URL de profil LinkedIn coûte 0,25 crédit si aucun email n’est trouvé. Les échecs dus à un incident de notre côté ne sont jamais débités.
Non. Les crédits sont facturés par résultat individuel, donc une opération groupée coûte le même prix par email, numéro ou vérification trouvé que les requêtes unitaires équivalentes. Les endpoints groupés font économiser des requêtes, pas des crédits.
L’Email Verifier consomme 0,25 crédit par vérification. L’Email Finder consomme 1 crédit par email trouvé, et le Phone Finder consomme 40 crédits par numéro trouvé (50 avec les anciens forfaits).
Les requêtes renvoient un statut HTTP 402. Les endpoints unitaires renvoient { "reason": "Insufficient credits", "success": false }, tandis que les endpoints groupés renvoient { "message": "..." }. Consultez Gestion des erreurs pour plus de détails.

​
Prochaines étapes

Authentification

Comment transmettre votre clé d’API dans l’en-tête x-api-key.

Infos du compte

Récupérez votre solde de crédits et vos webhooks enregistrés.

Limites de débit

Comprenez les limites de requêtes de l’API avant de monter en charge.

Gestion des erreurs

Gérez correctement les réponses d’erreur 402 et autres.