API SEO

Crea informes SEO y automatizaciones propios con JSON estructurado de tus proyectos de Screpy. Obtén hallazgos del rastreo, rankings de palabras clave, backlinks, AI Visibility almacenada y resultados de monitorización mediante una API REST por proyecto, con acciones compatibles para gestionar tu flujo de trabajo.

Leer la guía de inicio de la API Crear una cuenta de Screpy

Listar proyectos accesibles

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Fragmento de respuesta ilustrativo. El acceso REST requiere una cuenta de miembro de pago; la clave solo devuelve proyectos propios o compartidos a los que puedes acceder.

Autentica la SEO API

Crea una clave REST en Ajustes → Aplicaciones conectadas y envíala como token bearer desde tu servidor. Elige los permisos necesarios para tu integración.

Las claves de solo lectura obtienen datos; las de lectura y escritura también permiten cambios compatibles.
Copia el secreto al crearlo: se muestra una sola vez. No lo incluyas en código público del navegador.
Revoca claves en Aplicaciones conectadas. Se permiten hasta 20 claves activas y caducan al cabo de un año.

Leer la guía de autenticación

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Comprueba el acceso API

REST requiere una cuenta de miembro de pago. La pertenencia al proyecto y su elegibilidad para cada función también determinan los registros y las acciones disponibles.

Los endpoints de cuenta muestran tu plan, funciones y número de proyectos accesibles.
Los informes de uso incluyen límites por función, pero el consumo y la capacidad restante solo se calculan actualmente para proyectos propios.
Los valores de uso null indican información no disponible, no consumo cero.

Consultar endpoints de cuenta

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Gestiona proyectos SEO

Lista proyectos propios y compartidos, consulta una vista general o crea proyectos dentro de tu cupo de proyectos propios. Utiliza los UID devueltos en las siguientes peticiones.

Actualiza nombres, preferencias de mercado y zona horaria y ajustes de rastreo o monitorización compatibles.
Cambiar el dominio requiere un nuevo proyecto; modificar ajustes no reescribe resultados terminados.
La creación comprueba la capacidad y valida el sitio.
Solo el propietario puede eliminar el proyecto.

Consultar endpoints de proyectos

example.comProyecto

example.orgProyecto

example.netProyecto

Inicia rastreos web

Inicia un rastreo con acceso de escritura y conserva su UID. El rastreo se ejecuta en segundo plano: consulta su estado antes de obtener resultados.

Un rastreo en curso o el rastreador desactivado pueden impedir un nuevo inicio.
Los resúmenes y conjuntos de datos requieren un rastreo completado correctamente; los resultados sin terminar devuelven un conflicto.
Conserva juntas las referencias de proyecto y rastreo al informar o comparar instantáneas.

Consultar endpoints de rastreo

1
Revisión/guides
Abierto
2
Generado/shop
Abierto
Completadoexample.com
Pendiente

Obtén datos de rastreo SEO

Crea informes de SEO técnico a partir de un rastreo terminado seleccionado. Obtén detalles de páginas y localiza las páginas de origen de enlaces e imágenes.

Las páginas incluyen estado HTTP, títulos, descripciones, encabezados, canonical, profundidad de rastreo y tiempos.
Los registros de enlaces muestran destinos, textos de anclaje, estado nofollow y contexto de la página de origen.
Los registros de imágenes incluyen texto alternativo, dimensiones, estado de obtención y páginas de origen.
Usa filtros de campos compatibles y registros paginados; no es una exportación de HTML completo ni una interfaz SQL.

Consultar endpoints de datos de rastreo

/guides/seo200

Indexado

Compara proyectos y rastreos

Compara resúmenes de SEO técnico entre proyectos o instantáneas de rastreos terminados. Conserva referencias explícitas para reproducir las comparaciones.

Las comparaciones de proyectos aceptan entre dos y cinco proyectos accesibles con los últimos rastreos terminados o instantáneas seleccionadas.
Comparar dos rastreos devuelve cambios de salud, páginas y recuentos de problemas como segundo menos primero.
Son comparaciones de resúmenes; obtén los registros de rastreo por separado para investigar URL individuales.

Consultar endpoints de comparación

Antes62→Después87

Obtén SEO Quick Wins

Incorpora oportunidades priorizadas con su fuente y periodo. Una referencia de rastreo terminado verifica el acceso, pero no convierte cada oportunidad en una instantánea de ese rastreo.

Con datos conectados disponibles, Search Console ofrece oportunidades sobre consultas cercanas a primeras posiciones, CTR, canibalización, pérdidas y cambios de visibilidad.
Los hallazgos de enlaces internos pueden utilizar el último rastreo del proyecto indicado en los metadatos.
Los hallazgos derivados del tráfico requieren la conexión correspondiente, permisos y datos suficientes.
Conserva tipos de informe, fechas, avisos y disponibilidad; un informe vacío no demuestra que el sitio no tenga problemas.

Explorar Quick Wins

linen shirt#11

Impresiones

2860

Gestiona el seguimiento de rankings

Consulta visibilidad de palabras clave, historial y resultados almacenados con su mercado y dispositivo. Gestiona las palabras seguidas en lugar de solicitar resultados de búsqueda en vivo arbitrarios.

Filtra palabras por búsqueda, dispositivo y segmento basado en URL, incluidas las que no coinciden con segmentos.
Añade hasta 100 palabras por petición; el análisis inicial se pone en cola y no se devuelve inmediatamente.
Elimina palabras seguidas y previsualiza, crea, actualiza o elimina segmentos con acceso de escritura.
REST no ofrece consultas SERP en vivo, nuevos análisis manuales ni exportación CSV/XLSX de Rank Tracker.

Consultar endpoints de Rank Tracker

Posiciones

+24 Posición

Accede a AI Visibility

Relaciona respuestas de IA almacenadas con menciones de marca, citas y fuentes. Conserva el contexto de prompt, país, idioma y plataforma en tus propios informes.

Consulta resúmenes, menciones, respuestas, citas, prompts seguidos y actividad de dominios o URL de origen.
Añade hasta 20 prompts por petición dentro de la capacidad del proyecto o elimina prompts seguidos con acceso de escritura.
Las sugerencias de prompts, los nuevos análisis manuales y las exportaciones de AI Visibility no son operaciones REST.

Explorar AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analiza backlinks

Consulta el perfil de backlinks de un proyecto o de un competidor ya añadido, elegido en las opciones disponibles. Relaciona enlaces individuales con dominios de referencia para tus informes de autoridad.

Obtén métricas generales, dominios de referencia y los backlinks de un dominio seleccionado.
Revisa brechas de backlinks y conjuntos compatibles de dominios perdidos o con enlaces rotos.
Conserva objetivo, filtros, orden y cursor; no permite consultas ilimitadas de cualquier dominio.
Las exportaciones CSV/XLSX de tablas abarcan la página actual. Continúa con X-Next-Cursor.

Explorar Backlink Checker

example.org
example.net
example.edu

example.com84 Enlaces

Gestiona registros disavow

Guarda entradas revisadas de dominios o URL con notas en el proyecto y prepara un archivo de texto con formato de Google. Tú decides qué desautorizar.

El acceso de escritura permite añadir hasta 100 entradas por petición o eliminar registros existentes.
Exporta el texto disavow del proyecto por separado de las exportaciones de tablas paginadas.
Revisa y envía el archivo manualmente; guardar una entrada no la envía a Google ni elimina un backlink.

Explorar Disavow Management

disavow.txtRevisión

domain:example.org
https://example.net/links

Dominioexample.org
URLexample.net/links

Consulta la salud web

Separa rendimiento de páginas y disponibilidad del sitio en tus informes. Estos endpoints devuelven comprobaciones existentes, no una nueva medición bajo demanda.

Rendimiento devuelve la última página de inicio comprobada con FCP, LCP, CLS, TTFB, TBT y Speed Index, no todas las páginas ni un historial completo.
Uptime resume los últimos 30 días y devuelve hasta las 160 comprobaciones más recientes con estado, tiempo de respuesta y fecha.
Sin rendimiento se devuelve data:null; sin comprobaciones uptime, los valores del resumen siguen null y la lista queda vacía.

Consultar endpoints de salud

example.comLaboratorio

LCP2,1 s
TBT180 ms
CLS0,04

Pagina los datos SEO

Obtén conjuntos grandes en páginas manejables y conserva el contexto de la petición en tu proceso. Comprueba la disponibilidad antes de convertir respuestas en métricas del panel.

Las listas compatibles devuelven 50 registros por defecto y hasta 100; sigue los enlaces siguientes o cursores opacos.
Mantén filtros, objetivos y periodos constantes entre páginas. Los parámetros no válidos se rechazan.
Gestiona explícitamente errores de autorización, rastreo sin terminar, datos no disponibles y límites de peticiones, sin sustituir resultados ausentes por cero.

Leer la guía de errores API

JSONcursor_2

Habla de API SEO. Con SEO MCP.

Conecta tu asistente al proyecto de Screpy con SEO MCP. Selecciona un proyecto, revisa su resumen y explora datos compatibles de rastreo, posiciones y búsquedas con acceso delimitado.

Descubre Screpy SEO MCP Conecta tu asistente de IA

Preguntas sobre SEO API

Respuestas prácticas para elegir acceso REST, tratar registros y crear una integración fiable.

¿Cuáles son los límites de peticiones?

Por minuto, el límite base es de 300 peticiones por clave y 900 por cuenta. Los endpoints pesados permiten además 60 por clave y 180 por cuenta; los de escritura, 30 y 90. Las comprobaciones se aplican conjuntamente. Gestiona HTTP 429 y reintenta tras la espera permitida.

¿En qué se diferencian SEO API y SEO MCP?

SEO API sirve para tu propio software mediante peticiones REST y una clave bearer REST. SEO MCP ofrece herramientas compatibles a asistentes de IA mediante Model Context Protocol y su propia autorización. Las credenciales MCP no autentican REST y las operaciones disponibles no son idénticas.

¿Todos los resultados API son actuales o en vivo?

No. Los registros de rastreo pertenecen a la instantánea elegida; rankings y AI Visibility usan análisis almacenados. Quick Wins sigue su fuente y periodo. Los endpoints de salud devuelven comprobaciones existentes. Conserva fechas disponibles y contexto de origen en los informes.

¿La falta de datos significa que no hay problemas SEO?

No. Valores null, registros vacíos, avisos y errores de disponibilidad tienen significados distintos. Una medición de rendimiento ausente no es un fallo del sitio y un consumo no disponible no es consumo cero. Revisa la respuesta y la configuración antes de concluir.

¿Puedo exportar datos API a CSV o Excel?

Los endpoints de tablas de backlinks permiten CSV/XLSX de la página actual, con X-Next-Cursor para continuar. El texto disavow tiene una exportación separada. Las exportaciones CSV/XLSX de Rank Tracker y AI Visibility siguen siendo exclusivas del panel; otras respuestas estructuradas pueden alimentar tu código de informes.

¿REST expone todas las funciones del panel?

No. La referencia API enumera las operaciones REST compatibles. No hay endpoints REST para resultados de Map Tracker, generación de artículos, informes PDF o toda la analítica sin procesar. Rank Tracker y AI Visibility también tienen los límites de acciones y exportaciones indicados arriba.

¿Cómo encuentro el UID del proyecto y del rastreo?

Llama a GET /projects, selecciona un proyecto accesible y consulta su lista de rastreos. Usa juntos los UID devueltos. Los endpoints de resúmenes y datos requieren un rastreo completado correctamente.

¿Una clave de solo lectura sirve para todas las peticiones POST?

No. Las comparaciones POST de proyectos y rastreos aceptan lectura porque analizan registros existentes. Crear o modificar registros, iniciar rastreos y previsualizar segmentos requiere lectura y escritura. Consulta los permisos documentados en lugar de deducirlos del método HTTP.