API

Ejecuta análisis mediante una API REST con tu clave.

Autenticación

Crea una clave en tu Tu cuenta y envíala en la cabecera X-API-Key en cada petición. Cada análisis consume 1 crédito del saldo tuyo o de tu equipo.

Iniciar un análisis

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

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

Obtener el resultado

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

Consulta cada pocos segundos hasta que status sea completed. El campo report contiene entonces el JSON completo: resumen ejecutivo, acciones priorizadas y las secciones de brecha semántica, brecha de UX y preparación para IA.

Errores

401 — clave API no válida o revocada
402 — créditos insuficientes
422 — datos no válidos (url, query, country, language)
429 — demasiadas peticiónes, intentalo mas tarde

Crear clave API