API Docs — Integra análisis SEO en tu app

Introducción

La API de SEO Report te permite lanzar análisis SEO completos de cualquier URL desde tu propia aplicación. Obtienes los mismos datos que el informe web: técnico, backlinks, keywords, visibilidad en AI Search y recomendaciones.

🔧

Análisis técnico

🎯

Keywords & competencia

🤖

AI Search visibility

Autenticación

Todas las peticiones deben incluir tu API key en el header Authorization:

Authorization: Bearer sr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Genera tus API keys en Dashboard → API Keys. Requiere plan Pro, Agency o API.

Endpoint

POST https://seoreport.es/api/v1/analyze

Content-Type:application/json

Rate limit:10 requests / minuto

Tiempo máx:80 segundos

Request Body

JSON

{
  "url": "https://ejemplo.com"   // requerido
}

Campo	Tipo	Requerido	Descripción
`url`	string	✓	URL completa a analizar. HTTPS o HTTP.

Response

JSON — 200 OK

{
  "cached": false,
  "report_id": "api_686a...",
  "result": {
    "url": "https://ejemplo.com",
    "domain": "ejemplo.com",
    "analyzed_at": "2025-06-15T12:00:00+00:00",
    "overall_score": 72,
    "score_breakdown": {
      "technical": 80,
      "backlinks": 55,
      "keywords": 70,
      "competitors": 65,
      "ai_visibility": 60
    },
    "technical": { ... },
    "backlinks": { ... },
    "keywords": { ... },
    "competitors": { ... },
    "ai_visibility": { ... },
    "recommendations": { ... },
    "page_info": {
      "title": "Ejemplo — Mi Web",
      "final_url": "https://ejemplo.com/",
      "load_time_ms": 843,
      "page_size_kb": 124.5,
      "https": true
    },
    "ai_narrative": { ... }  // si OPENAI_API_KEY configurada
  }
}

Si cached: true, el resultado es de caché (máx. 24 horas). El análisis es idéntico.

Errores

Código	Motivo
400	Falta el campo `url` o URL inválida
401	API key ausente, inválida o revocada
405	Método no permitido (usar POST)
422	No se pudo acceder a la URL indicada
429	Rate limit superado (10 req/min)
500	Error interno del servidor

Ejemplo de error

{ "error": "Invalid or revoked API key." }

Ejemplos

curl -X POST https://seoreport.es/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"url": "https://tuwebsite.com"}'

<?php
$response = file_get_contents('https://seoreport.es/api/v1/analyze', false,
  stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Content-Type: application/json\r\nAuthorization: Bearer sr_live_xxxx",
    'content' => json_encode(['url' => 'https://tuwebsite.com']),
    'timeout' => 90,
  ]])
);
$data = json_decode($response, true);
echo $data['result']['overall_score']; // 72

const res = await fetch('https://seoreport.es/api/v1/analyze', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sr_live_xxxx'
  },
  body: JSON.stringify({ url: 'https://tuwebsite.com' })
});
const data = await res.json();
console.log(data.result.overall_score); // 72

import requests

response = requests.post(
    'https://seoreport.es/api/v1/analyze',
    headers={'Authorization': 'Bearer sr_live_xxxx'},
    json={'url': 'https://tuwebsite.com'},
    timeout=90
)
data = response.json()
print(data['result']['overall_score'])  # 72

Acceso a la API

🔜

API pública — Próximamente

El acceso a la API estará disponible en los planes Pro y Agency, que lanzaremos próximamente. Ver planes →

SEO Report API