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 5 000 requêtes (gratuit à vie) Découverte, prototypes, faibles volumes
Starter Selon abonnement Apps avec besoin de géolocalisation
Growth Selon abonnement Scoring socio-démographique, matrices distance
Business Selon abonnement Routage complet, enrichissement statistique INSEE

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
GET /version ouiouiouioui
GET /address/autocomplete ouiouiouioui
POST /address/verify ouiouiouioui
GET /address/view/{id} ouiouiouioui
GET /locality/autocomplete ouiouiouioui
GET /locality/search ouiouiouioui
POST /route/summary (matrice N×M) ——ouioui
POST /route/compute (itinéraire complet) ———oui

Richesse de la réponse par plan

Les endpoints d'adresses (autocomplete, verify, view) 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
position Starter 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é à 5 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 5000 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.

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, 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