Cola de trabajos de SEO scan para el sitio completo
API para desarrolladores
API de auditoría del sitio: pone en cola rastreos y lee resultados mediante programación
Pone en cola rastreos antes de los lanzamientos. Consulta hasta completarlo y obtén enlaces del informe: no hace falta ningún panel.
Trabajos asíncronos
Pone en cola rastreos, consulta hasta completar y obtiene enlaces del informe
La Site Audit API usa el mismo modelo de trabajos asíncronos que las integraciones de CI y cron: POST para poner en cola, GET para consultar y, cuando acabe el rastreo, lista los informes compartidos.
Quick start (curl)
Replace $XF_API_KEY and property IDs with values from your workspace. Full reference: Developer API docs.
curl -s -X POST \
-H "Authorization: Bearer $XF_API_KEY" \
-H "Idempotency-Key: scan-$(date +%s)" \
-H "Content-Type: application/json" \
-d @scan-body.json \
https://api.xenonflare.com/api/v1/properties/$XF_PROPERTY_ID/scansCrea tu propio rastreador vs. la API de XenonFlare
Construye internamente cuando…
- Navegadores sin interfaz (headless) — colas de cortesía e infraestructura de rastreo
- Reglas de puntuación — taxonomía de incidencias y almacenamiento de informes
- Autenticación del integrador — límites de tasa, idempotencia y sondeo de trabajos
- Supervisión — cuando los rastreadores se encuentran con protección anti-bot o problemas de TLS
Usa XenonFlare cuando…
- Cola de rastreos de sitio completo — con POST /properties/:id/scans
- Sondear el estado del trabajo — puntuación y número de incidencias mediante GET /jobs/:id
- Claves Bearer con alcance — claves de prueba para CI y generación de código con OpenAPI
- El mismo motor de rastreo — como app web con superposición de GSC + API
Flujo de trabajo del cliente
“Monitorizamos 40 sitios de clientes con un único panel interno. Rastros por lotes nocturnos, alertas por webhook cuando falla un rastreo y exportaciones de actividad en CSV para reporting de clientes—sin tener que iniciar sesión en cada propiedad.”
Agencia digital que usa la Developer API de XenonFlare en Growth
- 40 propiedades
- POST /scans/batch
- Historial de entregas de webhook
- Exportación de actividad en CSV
Flujo de integración típico
- Crea un workspace Starter o Growth y una clave de API con jobs:write
- Resuelve los IDs de propiedad con GET /properties
- Pon en cola un rastreo con POST /properties/:id/scans
- Sondea GET /jobs/:id hasta que el estado sea completed o failed
Lo que obtienes
Sondear estado, progreso y resultados
Listar enlaces activos de informes de auditoría compartidos
jobs:read/write, reports:read, properties:read
Idempotency-Key
Reintentos seguros en solicitudes de escritura
Límites de tasa
1.000 lecturas/hora y 60 escrituras/hora por clave (500 escrituras de organización/día)
FAQ
¿Las agencias pueden revender el acceso a la API a sus clientes?
Las agencias ejecutan un único workspace Growth con las propiedades de los clientes dentro, usando claves con alcance para el panel y los rastreos nocturnos. Se entrega a través de enlaces compartidos, webhooks o tu portal; los clientes no necesitan tener claves de API.
¿Qué plan incluye la Site Audit API?
El acceso a la API para desarrolladores requiere Starter o Growth. El plan Free incluye la app web y las herramientas gratuitas de xenonflare.com, pero no incluye claves de API.
¿En qué se diferencia de la herramienta de auditoría gratuita?
Las herramientas gratuitas ofrecen una vista rápida de una sola página sin necesidad de una cuenta. La API pone en cola rastreos de sitio completo vinculados a tu workspace, con historial de trabajos, límites de rastreo del plan e informes compartibles.
¿Cuáles son los límites de tasa de la API?
Los valores por defecto son 1.000 solicitudes de lectura por hora por clave, 60 solicitudes de escritura por hora por clave y 500 solicitudes de escritura por organización por día. Hasta 5 claves activas por workspace. Consulta la documentación de Developer API para más detalles.
Developer API en planes de espacio de trabajo de pago
Crea claves de API en la app web después de actualizar. El nivel gratis incluye el panel y herramientas de marketing gratuitas, no claves REST.