L'API de SEOClave

Démarrer en 2 minutes

1. Connectez-vous et ouvrez API (dans le menu).
2. Cliquez sur Créer une clé et copiez-la : elle ne s'affiche qu'une fois.
3. Testez-la (sans consommer de crédits) :

curl https://seoclave.com/api/v1/account/ \
  -H "Authorization: Bearer sc_VOTRE_CLE"

{
  "plan": "Pro",
  "balance": 150,
  "plan_expires": "2026-12-02T14:00:00+00:00",
  "limits": { "per_minute": 10, "requests_per_day": 1000, "credits_per_day": 50 },
  "today": { "requests": 1, "credits": 0 }
}

Authentification

Chaque requête porte l'en-tête Authorization: Bearer sc_…. La clé ne va jamais dans l'URL (elle finirait dans les historiques et les journaux) et ne fonctionne pas depuis la session du site. Traitez-la comme un mot de passe : qui l'a dépense vos crédits. Vous pouvez en avoir 3 et révoquer n'importe laquelle à tout moment ; quand vous en créez une, nous vous prévenons par e-mail.

Limites par offre

Par compte, toutes vos clés confondues. Ils sont obligatoires : ils protègent vos crédits et le service de tous.

Chaque réponse contient X-RateLimit-Limit et X-RateLimit-Remaining (pour la minute en cours) ; au-delà, la réponse est un 429 avec Retry-After en secondes. Ce qui est refusé par une limite n'est pas facturé.

Routes

curl https://seoclave.com/api/v1/keywords/ \
  -H "Authorization: Bearer sc_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"mode": "ideas", "query": "avocat droit du travail", "country": "fr", "limit": 50, "max_credits": 1}'

{
  "id": 812, "mode": "ideas", "cached": false, "empty": false,
  "result": { "rows": [
    { "keyword": "avocat droit du travail paris", "volume": 9900, "cpc": 18.4,
      "difficulty": 31, "intent": "commercial", "trend": [ … ] }
  ] },
  "credits": 1, "balance": 149, "notices": []
}

Combien ça coûte

Ne pas gaspiller de crédits

• Indiquez toujours max_credits. Si votre script construit mal une requête, il ne dépensera pas plus.
• Ne demandez que les lignes utiles. limit: 50 coûte 1 crédit ; 1 000 lignes, 7.
• Mesurez par lots. Une liste de 60 mots clés en volume coûte 1 crédit ; 60 requêtes séparées, 60.
• N'utilisez pas refresh en boucle. Les répétitions sont déjà gratuites 30 jours ; et avant 24 h, nous renvoyons ce que vous avez sans facturer.
• Gardez l'id. Relire /keywords/{id}/ est gratuit.
• Baissez votre plafond quotidien dans API pendant vos tests.
• Face à un 429, attendez ce qu'indique Retry-After : réessayer tout de suite ne sert à rien.

Erreurs

Toujours {"error": {"code": "…", "message": "…"}}. Le code ne change jamais : décidez avec lui. Le message est destiné aux personnes : il arrive dans la langue de l'en-tête Accept-Language (fr, en, es ou pt) ou, sinon, dans celle de votre compte.

Si vous utilisiez les noms espagnols

Jusqu'au 11 novembre 2026, l'API avait des routes et des champs en espagnol. Ils fonctionnent toujours de la même façon, avec réponses et codes en espagnol : vous n'avez rien à changer. Le mensaje des erreurs suit la même règle que message : Accept-Language, sinon la langue de votre compte, sinon l'espagnol. Pour du code nouveau, utilisez les noms anglais.

Connecteur MCP : Claude, Cursor et plus

MCP est le standard ouvert avec lequel les assistants d'IA utilisent des outils externes. Connectez SEOClave et votre IA interroge Google toute seule quand la conversation en a besoin : « combien de recherches pour avocat à Lyon ? », « quelle est ma position pour bottes en cuir ? ». Même clé, mêmes crédits, mêmes limites (seules les requêtes comptent, pas la poignée de main ni la liste des outils). Seules la recherche de mots clés (50 lignes = 1 crédit ; la répéter sous 30 jours est gratuit) et le top 10 (1 crédit) consomment des crédits ; l'estimation, l'audit, robots.txt, DNS, redirections et vos projets sont gratuits.

Adresse du connecteur : https://seoclave.com/api/v1/mcp

claude mcp add --transport http seoclave https://seoclave.com/api/v1/mcp \
  --header "Authorization: Bearer sc_VOTRE_CLE"

{
  "mcpServers": {
    "seoclave": {
      "url": "https://seoclave.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer sc_VOTRE_CLE" }
    }
  }
}

claude.ai (web et mobile) et Claude Desktop : en un clic

1. Sur claude.ai, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
2. Nom : SEOClave. Adresse : https://seoclave.com/api/v1/mcp.
3. Authentification : connexion OAuth, avec l'identité publiée de Claude ou l'enregistrement automatique (les deux fonctionnent). Sans en-têtes.
4. Cliquez sur Connecter : nous vous amenons sur SEOClave, vous vous connectez et cliquez sur Autoriser. Aucune clé à copier.

ChatGPT

1. Activez le mode développeur dans Paramètres → Apps et connecteurs → Avancé (selon votre offre ChatGPT).
2. Créez un connecteur avec l'adresse https://seoclave.com/api/v1/mcp et l'authentification OAuth.
3. Connectez-le : nous vous amenons sur SEOClave, vous vous connectez et cliquez sur Autoriser.

Les autres assistants qui acceptent des connecteurs MCP avec connexion (OAuth) se branchent de la même façon. Vous le voyez et le déconnectez dans API → Connexions.

Connectez-la à votre IA et à vos outils

• ChatGPT (GPT personnalisé) : dans Actions, importez le schéma depuis https://seoclave.com/api/v1/openapi.json et choisissez l'authentification « API Key » de type « Bearer » avec votre clé. Votre GPT pourra mesurer des mots clés et voir le top 10 du jour tout seul.
• n8n ou Make : un nœud HTTP Request avec l'en-tête Authorization: Bearer sc_….
• Claude et autres assistants : avec le connecteur MCP, votre IA interroge SEOClave toute seule.

import requests

r = requests.post("https://seoclave.com/api/v1/keywords/",
    headers={"Authorization": "Bearer sc_VOTRE_CLE"},
    json={"mode": "volume", "query": "chaussures\nbottes en cuir\nsandales", "country": "fr", "max_credits": 1},
    timeout=60)
r.raise_for_status()
for row in r.json()["result"]["rows"]:
    print(row["keyword"], row["volume"], row["cpc"])

const r = await fetch("https://seoclave.com/api/v1/keywords/", {
  method: "POST",
  headers: { Authorization: "Bearer sc_VOTRE_CLE", "Content-Type": "application/json" },
  body: JSON.stringify({ mode: "serp", query: "avocat lyon", country: "fr", max_credits: 1 }),
});
const data = await r.json();
if (!r.ok) throw new Error(data.error.code);
console.log(data.result.organic.slice(0, 3));

Des questions, ou il manque quelque chose ? Écrivez-nous depuis le centre d'aide. En utilisant l'API, vous acceptez les conditions.