API

Esegui analisi via API REST con la tua chiave.

Autenticazione

Crea una chiave nel tuo Il tuo account e inviala nell’header X-API-Key a ogni richiesta. Ogni analisi consuma 1 credito dal saldo tuo o del tuo team.

Avviare un’analisi

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": "it"
}

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

Recuperare il risultato

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

Interroga ogni pochi secondi finché status non è completed. Il campo report contiene allora il JSON completo: sintesi esecutiva, azioni prioritizzate e le sezioni gap semantico, gap UX e prontezza AI.

Errori

401 — chiave API non valida o revocata
402 — crediti insufficienti
422 — dati non validi (url, query, country, language)
429 — troppe richieste, riprova più tardi

Crea chiave API