TrustyData Docs
Site Tarifs Contact

Premier appel

De la création du compte au premier appel réussi, en 5 minutes. Aucun outil particulier — un terminal et curl suffisent.

1. Récupérer une clé d'API

Créez un compte sur trustydata.fr/inscription-beta. Une fois validé, vous accédez à votre espace client. Le plan Discovery (gratuit, 20 000 requêtes/mois) est attribué automatiquement.

Dans Espace client → Clés d'API, créez une clé et copiez-la immédiatement — elle ne sera plus jamais affichée en clair.

Une clé = un client

Une clé d'API identifie un seul client. Ne la partagez pas entre projets, ne l'embarquez pas dans une page web ou un binaire distribué. Pour les besoins multi-tenants (agences), un mode dédié existe — voir Authentification.

2. Premier appel — autocomplétion d'adresse

Toutes les requêtes prennent la même base URL et le même header d'authentification :

cURL

curl -H "Authorization: Bearer VOTRE_CLE_API" \
  "https://api.trustydata.app/services/v1/address/autocomplete?q=215+chemin+acacias+sainte-euphemie"

Python (requests)

import requests

response = requests.get(
    "https://api.trustydata.app/services/v1/address/autocomplete",
    params={"q": "215 chemin acacias sainte-euphemie"},
    headers={"Authorization": "Bearer VOTRE_CLE_API"},
)
response.raise_for_status()
data = response.json()
print(data["suggestions"][0]["adresse"])

Node.js (fetch)

const url = new URL("https://api.trustydata.app/services/v1/address/autocomplete");
url.searchParams.set("q", "215 chemin acacias sainte-euphemie");

const response = await fetch(url, {
  headers: { Authorization: "Bearer VOTRE_CLE_API" },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.suggestions[0].adresse);

3. Lire la réponse

Toutes les réponses suivent une structure stable : status, message, et le contenu utile (suggestions, matches, results selon l'endpoint). 

{
  "status": "OK",
  "message": "",
  "suggestions": [
    {
      "score": 0.99,
      "adresse": "215 Chemin des Acacias, 01600 Sainte-Euphémie",
      "id": "8dce49b2-8e26-4e72-a81d-ff1c1f0072f6",
      "id_ban": "01353_0100_00215",
      "numero": "215",
      "nom_voie": "Chemin des Acacias",
      "code_postal": "01600",
      "nom_commune": "Sainte-Euphémie",
      "code_insee": "01353"
    }
  ]
}

Le champ score (0 à 1) indique la pertinence du rapprochement par rapport à la requête. Un score ≥ 0,9 est un match fiable ; entre 0,6 et 0,9 c'est un candidat à vérifier ; en dessous, mieux vaut affiner la requête.

Réponse enrichie par plan

En plan Discovery, la réponse contient les champs base BAN (numéro, voie, code postal, commune, code INSEE, identifiant BAN). Les plans supérieurs ajoutent progressivement la position (Starter), le géocodage IRIS (Growth), et la grille statistique INSEE Filosofi (Business). Voir Plans & quotas.

4. Aller plus loin avec les adresses

L'autocomplétion n'est qu'un des quatre endpoints adresse. Pour vérifier une adresse déjà saisie (verdict match_exact / match_probable), consulter une fiche ou chercher autour d'un point : voir le guide Adresses.

5. Sans écrire de code — Zapier

Les mêmes services existent en étapes de Zap, via l'intégration TrustyData sur Zapier (listée en bêta dans l'annuaire) : vérification d'adresse, recherche d'entreprise et d'établissement SIRENE, recherche de commune, calcul d'itinéraire. L'authentification est la même clé d'API que ci-dessus, collée une seule fois à la connexion.

Deux propriétés valent d'être connues avant de construire un Zap. Chaque action renvoie toujours les mêmes champs, quel que soit votre plan : ce que le plan n'ouvre pas vaut null au lieu de disparaître, et un champ plan_requis_pour nomme le palier qui le débloque — un Zap déjà construit ne casse donc pas quand vous changez d'abonnement. Et les cinq actions sont des Searches : quand rien n'est trouvé, le Zap continue avec des champs vides au lieu de tomber en erreur.

Prochains pas