API SEO

La API SEO de Screpy es una API REST para llevar datos de proyectos, rastreos, Rank Tracker, AI Visibility almacenada, páginas, monitorización y oportunidades a tus propios productos, paneles y automatizaciones. Usa respuestas JSON estructuradas para crear flujos SEO con los datos a los que tiene acceso tu cuenta de Screpy.

Iniciar prueba gratuita Ver precios

TL;DR

Demasiado largo; no leído

Mostrar resumen

¿Qué es la API SEO de Screpy?

La API SEO de Screpy es una API REST para cuentas de miembros de pago que expone proyectos, rastreos completados, Rank Tracker, datos de AI Visibility almacenados y gestión de prompts, comparaciones, Core Web Vitals y disponibilidad mediante solicitudes JSON autenticadas. Está diseñada para software personalizado, sistemas de informes y automatizaciones; usa una clave de API REST, no credenciales OAuth de MCP.

Acceso y contexto de la cuenta

Las claves de la API SEO de Screpy se crean en Ajustes → Aplicaciones conectadas y se envían como tokens Bearer en cada solicitud REST.
La API SEO de Screpy está disponible para cuentas de miembros de pago y comprueba la elegibilidad, los límites de funciones y el acceso al proyecto en cada solicitud.
La API SEO de Screpy muestra los proyectos propios o compartidos con la cuenta autenticada, empezando por GET /projects.
La API SEO de Screpy devuelve el uso de la cuenta, los límites del plan, el crédito restante y la disponibilidad de funciones antes de iniciar rastreos o procesar grandes resultados.

Proyectos, rastreos y comparaciones

La API SEO de Screpy lista, crea, actualiza y elimina proyectos accesibles para aplicaciones SEO personalizadas y flujos de clientes.
La API SEO de Screpy usa un UID de proyecto para las solicitudes específicas y devuelve un UID de rastreo desde la lista de rastreos del proyecto seleccionado.
La API SEO de Screpy devuelve el estado del rastreo, resúmenes de rastreos completados, indicadores de salud, recuentos de problemas y totales para flujos de SEO técnico.
La API SEO de Screpy compara dos rastreos completados para que un panel o una automatización pueda investigar cambios entre referencias de SEO técnico.

Registros de rastreo y datos de monitorización

La API SEO de Screpy devuelve páginas, enlaces, imágenes, hallazgos on-page y Quick Wins de un rastreo completado seleccionado.
La API SEO de Screpy mantiene juntos el alcance del proyecto y del rastreo y admite paginación para grandes conjuntos de resultados.
La API SEO de Screpy devuelve Core Web Vitals y datos de disponibilidad mediante endpoints de salud separados, porque el rendimiento y la disponibilidad son señales distintas.
La API SEO de Screpy puede devolver data: null cuando no hay una comprobación de salud coincidente. Las integraciones deben confirmar la configuración de monitorización antes de considerarlo un fallo del sitio.

Conecta tu producto con datos SEO.

Crea una clave de API REST, descubre los proyectos a los que puede acceder tu cuenta y usa identificadores estables de proyecto en tu panel, automatización o aplicación.

Más información sobre acceso a la api rest

Crear claves de API REST en Ajustes → Aplicaciones conectadas
Autenticar solicitudes con un token Bearer
Descubrir proyectos propios y compartidos antes de elegir un UID de proyecto
Consultar el uso y los límites de funciones antes de los flujos costosos

GET /v1/projects 200 OK

{
  "data": [
    {
      "uid": "prj_8f3a1",
      "name": "Example site",
      "domain": "example.com",
      "role": "owner"
    }
  ]
}

Ejecuta flujos de rastreo desde tu propia plataforma.

Conecta la gestión de proyectos, el estado de los rastreos, los resúmenes completados y las comparaciones con los sistemas que tu equipo ya usa para sus operaciones SEO.

Más información sobre proyectos y rastreos

Crear y gestionar proyectos accesibles de Screpy mediante endpoints REST
Usar UIDs de proyecto y rastreo para leer un sitio y un rastreo seleccionados
Supervisar el progreso, los indicadores de salud, los problemas y los totales
Comparar rastreos completados cuando haya que investigar un lanzamiento, migración o cambio de contenido

GET /v1/projects/{project_uid}/crawls 200 OK

{
  "data": [
    {
      "uid": "crw_42c91",
      "status": "completed",
      "health": { "score": 91 },
      "issues": { "critical": 2, "warnings": 14 }
    }
  ]
}

Convierte registros SEO en automatizaciones.

Usa registros de rastreos completados, Quick Wins, comprobaciones de rendimiento y señales de disponibilidad como entradas estructuradas para informes, notificaciones y flujos SEO internos.

Más información sobre datos de rastreo y salud

Recuperar páginas, enlaces, imágenes y hallazgos on-page de un rastreo completado
Usar Quick Wins para oportunidades priorizadas de Search Console
Paginar grandes conjuntos de rastreo sin mezclar registros de distintos rastreos
Mantener Core Web Vitals y comprobaciones de disponibilidad junto a los datos que requieren seguimiento

POST /v1/comparisons/crawls 200 OK

{
  "data": {
    "change": {
      "health_score": 4,
      "critical_issues": -3,
      "indexable_pages": 12
    }
  }
}

Endpoints de la API SEO para flujos personalizados

Construye directamente sobre los datos y flujos de Screpy que importan a tu producto: acceso a la cuenta, proyectos, rastreos, Rank Tracker, AI Visibility almacenada, registros detallados, comparaciones y salud del sitio.

Claves de API REST

Crea una clave de API REST en Ajustes → Aplicaciones conectadas y autentica cada solicitud con un token Bearer.

Uso de la cuenta

Consulta los límites del plan, los créditos de funciones y el uso restante antes de iniciar rastreos o procesar muchos registros.

Gestión de proyectos

Lista, crea, actualiza y elimina los proyectos de Screpy disponibles para la clave de API REST en tu flujo personalizado.

Flujos de rastreo

Lee la lista de rastreos de un proyecto y usa el UID devuelto para conectar resultados seleccionados con tu aplicación.

Resúmenes de rastreo

Devuelve estado, indicadores de salud, recuentos de problemas, totales y progreso para informes y monitorización SEO técnica.

Comparaciones de rastreos

Compara dos rastreos completados cuando tu producto necesite mostrar qué cambió entre referencias SEO técnicas.

Registros de páginas

Recupera registros de páginas y detalles exactos para análisis técnico SEO por URL en una interfaz personalizada.

Registros de enlaces e imágenes

Recupera enlaces e imágenes descubiertos junto con el contexto de su página de origen desde un rastreo completado.

Hallazgos on-page

Usa el contexto de auditoría on-page y los registros de rastreo para crear una revisión técnica centrada en URLs importantes.

Quick Wins

Lleva oportunidades priorizadas de Search Console a un panel o automatización interna con el contexto del proyecto y del periodo.

API de Rank Tracker

Lee visibilidad, historial de palabras clave, resultados almacenados y segmentos; añade o elimina palabras rastreadas y gestiona segmentos basados en URL.

API de AI Visibility

Lee datos almacenados de resumen, menciones, respuestas, citas, prompts y fuentes; añade o elimina de forma lógica prompts rastreados dentro del límite del plan.

Datos de Core Web Vitals

Recupera resultados disponibles de Core Web Vitals mediante la API de salud para flujos SEO centrados en el rendimiento.

Datos de disponibilidad

Recupera el estado de disponibilidad y los incidentes recientes para mostrar estas señales junto a los datos técnicos de SEO.

Preguntas sobre la API SEO.

Descubre cómo la API REST de Screpy autentica solicitudes, delimita proyectos y rastreos y expone datos para productos SEO y automatizaciones personalizadas.

¿Cómo creo una clave de API SEO de Screpy?

Crea una clave de API REST en Ajustes → Aplicaciones conectadas y envíala como token Bearer en cada solicitud. Las credenciales OAuth de MCP no autentican la API REST de Screpy.

¿Quién puede usar la API SEO de Screpy?

La API REST de Screpy está disponible para cuentas de miembros de pago. Cada solicitud comprueba la elegibilidad, los límites y el acceso al proyecto solicitado.

¿Cómo encuentro un UID de proyecto y un UID de rastreo?

Empieza con GET /projects para listar los proyectos disponibles para la clave. Usa el UID del proyecto seleccionado con su lista de rastreos, que devuelve el UID para las solicitudes de datos.

¿Qué datos puede devolver la API SEO de Screpy?

Para un rastreo completado seleccionado, la API REST puede devolver páginas, enlaces, imágenes, hallazgos on-page y Quick Wins. Mantén juntos el alcance del proyecto y del rastreo al crear informes o automatizaciones.

¿Puede la API SEO de Screpy comparar rastreos?

Sí. La API de comparaciones acepta dos referencias de rastreos completados y devuelve una comparación estructurada para investigar cambios entre sus referencias.

¿Puedo gestionar Rank Tracker mediante la API?

Sí. La API admite el resumen de Rank Tracker, la gestión de palabras clave, el historial y los resultados almacenados y la vista o gestión de segmentos. No ofrece exportación CSV/XLSX, consulta SERP en directo ni reanálisis manual.

¿Puedo usar AI Visibility mediante la API?

Sí. La API lee datos almacenados de resumen, menciones, respuestas, citas, prompts y fuentes y puede añadir o eliminar lógicamente prompts. Las exportaciones CSV y Excel son exclusivas del panel y las sugerencias o el reanálisis manual no están disponibles en la API.

¿Puedo obtener Core Web Vitals y disponibilidad mediante la API?

Sí. Core Web Vitals y disponibilidad se exponen mediante endpoints de salud separados porque son señales distintas. Una respuesta data: null puede indicar que aún no hay una comprobación coincidente.

¿En qué se diferencia la API SEO de Screpy de SEO MCP?

La API SEO de Screpy es una API REST para productos, paneles y automatizaciones personalizados que se autentica con una clave REST. Screpy SEO MCP expone herramientas estructuradas a asistentes de IA compatibles mediante OAuth y el Model Context Protocol.