Révélations et coûts

Ce qu’apporte une révélation, ce qu’elle coûte et quand elle est gratuite.

Une révélation débloque une entreprise : son domaine, son site web, ses emails, ses téléphones et ses contacts nommés. Elle coûte une unité de votre quota mensuel, comme sur le site, et ce quota est partagé avec votre utilisation du site.

Ce qui est gratuit

• Chercher, compter, lire une fiche et toutes les listes de référence ne consomment aucun quota.
• Révéler de nouveau une entreprise pendant la même période de facturation ne coûte rien : charged vaut false.
• Vérifier le coût avec GET /businesses/{id}/reveal ne coûte rien.

Après la fin de la période

Le domaine et le site web d’une entreprise que vous avez révélée restent visibles pour vous définitivement. Les coordonnées suivent la période : les revoir pendant une nouvelle période nécessite une nouvelle révélation, qui coûte une unité.

Rien n’est consommé par accident

• Avec REST, seul POST /businesses/{id}/reveal consomme du quota. Les lectures refusent l’ancien paramètre reveal= avec 400 use_reveal_endpoint.
• Avec MCP, seul reveal_company consomme du quota, et uniquement avec confirm: true. Sans cela, l’outil renvoie le coût.

Quand une révélation est refusée

• 402 quota_exhausted : plus aucune révélation disponible. Rien n’a été consommé.
• 404 not_found : l’entreprise n’existe pas ou a été retirée à la demande de son propriétaire.
• 409 email_invalid : son email est marqué comme invalide. Rien n’a été consommé.
• 429 rate_limited : trop de révélations cette minute. Rien n’a été consommé.

Entreprises ayant demandé leur retrait

Une entreprise retirée à la demande de son propriétaire disparaît de tous les endpoints et de tous les outils, et ne peut pas être révélée.

Retour à findbytown