API

Lancez des analyses par API REST avec votre propre clé.

Authentification

Créez une clé dans votre Votre compte et envoyez-la dans l’en-tête X-API-Key à chaque requête. Chaque analyse consomme 1 crédit sur votre solde ou celui de votre equipe.

Lancer une analyse

POST https://serptune.com/api/v1/analyze
X-API-Key: stk_xxxxxxxx.xxxxxxxx
Content-Type: application/json

{
  "url": "https://example.com/your-page",
  "query": "best running shoes",
  "country": "US",
  "language": "en",
  "report_locale": "fr"
}

Réponse: { "uuid": "…", "status": "queued", "result_url": "https://serptune.com/api/v1/analysis?id=…" }

Récupérer le resultat

GET https://serptune.com/api/v1/analysis?id=<uuid>
X-API-Key: stk_xxxxxxxx.xxxxxxxx

Interrogez toutes les quelques secondes jusqu’à ce que status vaille completed. Le champ report contient alors le JSON complet : synthèse, actions priorisées et les sections écart sémantique, ecart UX et aptitude à l’IA.

Erreurs

401 — clé API invalide ou révoquée
402 — crédits insuffisants
422 — donnees invalides (url, query, country, language)
429 — trop de requêtes, réessayez plus tard

Créer une clé API