Démarrage rapide

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é

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.

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.

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 https://api.spottracker.fr/v1/me \
  -H "Authorization: Bearer st_votre_cle"

const res = await fetch("https://api.spottracker.fr/v1/me", {
  headers: { Authorization: `Bearer ${process.env.SPOTTRACKER_API_KEY}` },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://api.spottracker.fr/v1/me",
    headers={"Authorization": f"Bearer {os.environ['SPOTTRACKER_API_KEY']}"},
)
print(res.json())

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.

Démarrer

Concepts

Référence API

1. Créer une clé

2. Vérifier la clé

3. Lire vos entreprises

4. Synchroniser sans tout relire

Et ensuite

Authentification

Pagination

Limites de débit

Référence API

​1. Créer une clé

​2. Vérifier la clé

​3. Lire vos entreprises

​4. Synchroniser sans tout relire

​Et ensuite

Authentification

Pagination

Limites de débit

Référence API

1. Créer une clé

2. Vérifier la clé

3. Lire vos entreprises

4. Synchroniser sans tout relire

Et ensuite