Démarrage rapide

Ce guide vous mène d'un nouveau compte à votre première requête API authentifiée en quelques minutes.

1. Créer un espace de travail

Inscrivez-vous et créez un espace de travail pour chaque site (ou client) que vous gérez. Un espace de travail possède son propre réservoir de mots-clés, son profil de backlinks et son pipeline de contenu, ainsi que les sièges et intégrations qui lui sont rattachés.

2. Générer une clé API

Dans Réglages → Clés API, créez une clé. Traitez-la comme un mot de passe — elle donne un accès complet à l'espace de travail. Stockez-la dans une variable d'environnement, jamais dans le code source.

export SEO_INSIGHT_API_KEY="sk_live_xxxxxxxxxxxxxxxx"

3. Envoyer votre première requête

Chaque endpoint vit sous https://api.seoinsight.app/v1. Authentifiez-vous avec un token Bearer. Voici une requête sur le réservoir de mots-clés de l'espace de travail courant :

curl https://api.seoinsight.app/v1/keywords \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY" \
  -G -d "limit=3"

Une réponse réussie renvoie du JSON :

{
  "data": [
    { "keyword": "seo mcp tool", "volume": 880, "kd": 34, "cpc": 3.1, "position": 12 },
    { "keyword": "seo mcp server", "volume": 320, "kd": 28, "cpc": 2.4, "position": 14 }
  ],
  "has_more": true
}

4. Essayer depuis le code

Le même appel depuis un service TypeScript :

const res = await fetch("https://api.seoinsight.app/v1/keywords?limit=3", {
  headers: { Authorization: `Bearer ${process.env.SEO_INSIGHT_API_KEY}` },
});
 
const { data } = await res.json();
console.log(data);

Étapes suivantes

PrécédentIntroductionSuivant MCP & agents IA