Démarrage rapide

Créer une clé, vérifier qu’elle fonctionne, lire vos premières entreprises.

L’accès API est inclus à partir de l’offre Growth. Sur l’offre Starter, la création de clé est refusée. Voir les offres

​

1. Créer une clé

1. Ouvrir Administration → Tracking

   Dans l’application, la section Tracking regroupe le script à poser sur vos sites et vos clés d’API. Le panneau des clés se trouve sous le script et le webhook.

2. Générer la clé

   Donnez-lui un nom qui décrit son usage — « export entrepôt », « synchronisation CRM ». Une clé par usage : révoquer l’une n’interrompt alors pas les autres.

3. La copier immédiatement

   La valeur complète n’est affichée qu’à la création. Elle n’est ensuite plus consultable, y compris par le support : une clé perdue se révoque et se recrée.

Une clé ressemble à st_ suivi d’une chaîne aléatoire.

​

2. Vérifier la clé

GET /v1/me est le point de test d’une intégration. Il ne renvoie aucune donnée métier : il confirme que la clé est valide et indique quel workspace elle vise.

curl

curl https://api.spottracker.fr/v1/me \
  -H "Authorization: Bearer st_votre_cle"

Réponse

{
  "id": "clx3k9v2p0000qw8h1a2b3cde",
  "name": "Atelier Vermeil",
  "plan": "growth"
}

Si vous recevez un 401, reportez-vous à Erreurs : plusieurs causes distinctes produisent cette même réponse.

​

3. Lire vos entreprises

curl "https://api.spottracker.fr/v1/companies?limit=10" \
  -H "Authorization: Bearer st_votre_cle"

Les entreprises arrivent triées par score d’intention décroissant : la première page est donc, par construction, celle qui mérite un appel.

​

4. Synchroniser sans tout relire

Pour une synchronisation régulière, ne repaginez pas l’intégralité du jeu à chaque passage. Conservez la date du dernier passage réussi et repassez-la dans since :

curl "https://api.spottracker.fr/v1/companies?since=2026-08-24T00:00:00Z" \
  -H "Authorization: Bearer st_votre_cle"

Enregistrez la date avant de lancer la lecture, pas après : entre le début et la fin d’une pagination longue, de nouvelles visites arrivent. Une date prise à la fin les ferait manquer au passage suivant.

​

Et ensuite

Authentification

Portée d’une clé, rotation, révocation.

Pagination

limit, offset, since et l’enveloppe de réponse.

Limites de débit

120 requêtes par minute, et comment les respecter.

Référence API

Toutes les routes, champ par champ, avec un bac à sable pour les essayer.