TrustyData Docs
Site Tarifs Contact

Plans & quotas

Le plan attaché à votre clé contrôle deux choses : quels endpoints vous pouvez appeler, et quel niveau d'enrichissement vous recevez en retour. Pour la grille tarifaire, voir trustydata.fr/tarifs.

Les quatre plans

Plan Quota mensuel Cible
Discovery 20 000 requêtes (gratuit à vie) Découverte, prototypes, faibles volumes
Starter 100 000 requêtes Apps avec besoin de géolocalisation
Growth 500 000 requêtes Scoring socio-démographique, matrices distance
Business 2 000 000 requêtes Routage complet, enrichissement statistique INSEE

Le Pass Zones

Le Pass Zones (code de plan zones) n'est pas un cinquième palier mensuel : c'est un achat unique de 30 € HT (36 € TTC), valable 15 jours, payé par carte depuis l'espace client (écran Abonnement, page « Acheter le Pass Zones »), sans renouvellement.

  • Ce qu'il ouvre : POST /zone/stats, POST /zone/compare, POST /zone/synthese, la portée par durée (duree) de GET /locations/search, Mes zones en entier et les outils MCP zone_stats et zone_compare.
  • Quota : 500 000 unités sur la durée du pass, plafond net. Au-delà, 429 ; aucun dépassement n'est jamais facturé.
  • Le pass remplace le plan pendant 15 jours : Mes lieux (capacité à zéro, « Afficher mes sites » ne montre rien) et les services d'adresses, d'entreprises et d'itinéraires ne sont pas ouverts pendant le pass.
  • À l'échéance, le compte retourne sur Discovery.

Endpoints accessibles par plan

Toutes les clés peuvent appeler les endpoints d'autocomplétion et de vérification ; les endpoints de routage et certains champs enrichis sont réservés aux plans supérieurs.

Endpoint Discovery Starter Growth Business Pass Zones
GET /version ouiouiouiouioui
GET /address/autocomplete ouiouiouioui—
POST /address/verify ouiouiouioui—
GET /address/view/{id} ouiouiouioui—
GET /address/proximity (recherche par rayon) ——ouioui—
GET /locality/autocomplete ouiouiouioui—
GET /locality/search ouiouiouioui—
POST /route/summary (matrice N×M) ——ouioui—
POST /route/compute (itinéraire complet) ———oui—
POST /zone/stats (population, ménages, niveau de vie moyen d'une zone) ——ouiouioui
POST /zone/compare (comparaison de 2 à 10 zones) ——ouiouioui
POST /zone/synthese (avis rédigé sur une zone) ——ouiouioui
GET /locations/search avec duree (portée par temps de trajet) ——ouiouioui

Richesse de la réponse par plan

Les endpoints d'adresses (autocomplete, verify, view, et chaque résultat de proximity) retournent un payload dont la richesse dépend du plan. Plus le plan est élevé, plus de champs sont ajoutés — la structure reste compatible.

Champ ajouté À partir de Quoi
Base BAN Discovery Numéro, voie, code postal, commune, code INSEE, identifiant BAN
Lignes postales Discovery ligne_voie, ligne_complement, ligne_commune — l'adresse déjà composée en trois lignes, prête pour un formulaire ou une fiche CRM (détail)
position Discovery Latitude/longitude WGS84 + coordonnées projetées Lambert 93 (x/y)
geocoding Growth Code IRIS, nom IRIS, type IRIS (zonage infra-communal INSEE)
statistical_grid Business Grille statistique INSEE Filosofi 200 m + indicateurs socio-démographiques (revenus, structure des ménages, âges, types de logement)

Compatibilité ascendante

Un client codé contre Discovery fonctionnera tel quel sur Business : les nouveaux champs sont ajoutés sans modifier l'existant. Vous pouvez donc upgrader sans changement de code, puis lire les champs supplémentaires quand vous en avez besoin.

Quotas et dépassement

Le plan Discovery est plafonné à 20 000 requêtes par mois, sans facturation au dépassement — c'est un hard cap. Au-delà, les requêtes répondent 429 Too Many Requests jusqu'au début du mois suivant. 

{
  "detail": "Rate limit exceeded. Max allowed usage for plan DISCOVERY is 20000 requests."
}

Les plans payants (Starter, Growth, Business) suivent les volumes contractuels de votre abonnement. Le quota est lisible en temps réel depuis l'espace client.

Le Pass Zones a son propre plafond : 500 000 unités sur ses 15 jours, sans dépassement facturé. Une fois le plafond atteint, les requêtes répondent 429 jusqu'à l'échéance du pass. 

{
  "detail": "Rate limit exceeded. Max allowed usage for plan ZONES is 500000 requests."
}

Une erreur serveur n'est jamais décomptée. Un appel qui se termine par un code 5xx (500, 502, 503, 504) ne consomme aucune unité, quel que soit l'endpoint, via l'API REST comme via le serveur MCP : la panne n'est pas de votre fait. Un appel qui aboutit compte une unité même quand il ne trouve rien (200 sans résultat, 404) — le travail a été fait.

Cas d'usage type par plan

  • Discovery — formulaire de contact avec autocomplétion, validation à l'inscription sur un site faible-volume, prototype interne.
  • Starter — application qui a besoin de placer un point sur une carte (livraison à domicile, prise de rendez-vous physique).
  • Growth — scoring de prospects par zone IRIS, qualification de leads par temps de trajet à un point de vente, recherche d'adresses autour d'un point (proximité), segmentation socio-démo légère.
  • Business — calcul d'itinéraire complet pour apps de tournée, enrichissement statistique poussé pour scoring crédit / assurance / marketing.

Changer de plan

Le changement de plan se fait depuis l'espace client. L'upgrade est immédiat — vous bénéficiez des nouveaux endpoints et champs à la prochaine requête. Le downgrade (et l'annulation, qui équivaut à un retour vers Discovery) prend effet à la fin de la période de facturation en cours.

Prochains pas