> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spottracker.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

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

<Note>
  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](https://www.spottracker.fr/tarifs)
</Note>

## 1. Créer une clé

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.spottracker.fr/v1/me \
    -H "Authorization: Bearer st_votre_cle"
  ```

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

  ```python Python theme={null}
  import os, requests

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

```json Réponse theme={null}
{
  "id": "clx3k9v2p0000qw8h1a2b3cde",
  "name": "Atelier Vermeil",
  "plan": "growth"
}
```

Si vous recevez un `401`, reportez-vous à [Erreurs](/erreurs) : plusieurs
causes distinctes produisent cette même réponse.

## 3. Lire vos entreprises

```bash theme={null}
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` :

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

<Tip>
  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.
</Tip>

## Et ensuite

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/authentification">
    Portée d'une clé, rotation, révocation.
  </Card>

  <Card title="Pagination" icon="list" href="/pagination">
    `limit`, `offset`, `since` et l'enveloppe de réponse.
  </Card>

  <Card title="Limites de débit" icon="gauge" href="/limites-de-debit">
    120 requêtes par minute, et comment les respecter.
  </Card>

  <Card title="Référence API" icon="code" href="/reference/verifier-une-cle">
    Toutes les routes, champ par champ, avec un bac à sable pour les essayer.
  </Card>
</CardGroup>