Cómo usar la API de SE Ranking: guía para profesionales SEO

Abrir una herramienta, seleccionar un proyecto, aplicar filtros, exportar un archivo, limpiar los datos y llevarlos a un informe. Una vez no parece gran cosa. Repetirlo cada semana para veinte clientes ya se parece bastante a una condena administrativa.

Pues, estás de suerte, porque la API de SE Ranking te va a evitar buena parte de ese trabajo repetitivo.

Con las APIs SEO puedes solicitar datos desde un script, una aplicación, una hoja de cálculo o una plataforma de business intelligence. La información llega en un formato estructurado que puedes procesar, cruzar con otras fuentes y transformar en informes, alertas o flujos de trabajo.

Esta guía recorre lo esencial para empezar: qué puedes hacer con la SEO API de SE Ranking, cómo autenticarte, cómo lanzar tu primera petición y tres casos de uso con código real que puedes copiar y adaptar hoy.

¿Qué puedes hacer con la API de SE Ranking?

SE Ranking agrupa sus funciones en dos grandes áreas: Data API y Project API. Ambas utilizan la misma clave y el mismo dominio base, api.seranking.com.

Data API

La Data API te da acceso a los datos de investigación SEO de SE Ranking sin necesidad de tener un proyecto creado.

Es la que usarás para consultar métricas de cualquier dominio, incluidos los de la competencia: visión general de tráfico y palabras clave, análisis de backlinks, investigación de keywords, auditoría técnica de sitios y visibilidad en la búsqueda con IA (Google AI Overviews, ChatGPT, Gemini o Perplexity).

Su consumo se calcula mediante créditos. Cada endpoint tiene un coste que puede depender de la petición, del número de registros devueltos o de ambos factores. Las respuestas con códigos HTTP 2xx consumen créditos; los errores 4xx y 5xx no se cobran.

Project API

La Project API trabaja sobre tus proyectos dentro de tu cuenta de SE Ranking.

Sirve para gestionar seguimiento de posiciones, competidores, grupos de keywords, backlinks monitorizados, plan de marketing y subcuentas.

Es la vía para automatizar la operativa diaria de tus proyectos y clientes.
En este caso, las acciones consumen los límites de la suscripción de SE Ranking, igual que si las ejecutaras desde la plataforma.

Con esas dos piezas cubres casi cualquier flujo: desde alimentar un informe automático de posiciones hasta detectar oportunidades de contenido comparando tu dominio con el de un rival.

Y no siempre hace falta programar de cero.

SE Ranking ofrece integraciones listas con Looker Studio (Data Studio), n8n, Make.com y un conector MCP para llevar tus datos SEO y GEO a herramientas de IA como ChatGPT.

Si automatizas SEO con flujos no-code, tienes medio camino hecho.

La Data API te ayuda a investigar cualquier dominio o mercado; la Project API te permite gestionar tu operativa dentro de SE Ranking.

En esta guía nos vamos a centrar en la Data API, que es la puerta de entrada más habitual y la que ilustra mejor el potencial de una API SEO.

¿Cómo obtener acceso a la API de SE Ranking?

El primer paso es activar el acceso y generar una clave.

SE Ranking ofrece el paquete de API como producto independiente y dispone de una prueba de 14 días con 100.000 créditos.

Después de acceder a la cuenta, encontrarás el panel en Perfil y preferencias > Dashboard de la API o desde la opción API del menú lateral.

Dentro del panel:

• Pulsa en Crear clave API.
• Añade un nombre que te permita identificar su uso.
• Genera la clave.
• Cópiala y guárdala en un lugar protegido.

Puedes crear claves diferentes para producción, pruebas o aplicaciones distintas. Esto facilita revocar una integración sin afectar al resto.
Veámoslo paso a paso.

Autenticación y primeros pasos

Todas las peticiones parten de la misma URL base: https://api.seranking.com

Y todas exigen autenticación. El proceso tiene tres pasos: consigue tu clave, autentícate y lanza una llamada de prueba.

1. Consigue tu clave API

La clave se genera desde el panel de tu cuenta.

Entra en el API Dashboard (icono API en el menú lateral izquierdo de SE Ranking), pulsa + CREATE API KEY, ponle un nombre descriptivo (por ejemplo, «Demo» o «Automatización informes») y confirma con CREATE KEY.

La clave aparece en la tabla de API Keys. Puedes crear varias, una por proyecto o por entorno, algo recomendable para no mezclar usos ni tener que revocar todo si una se filtra.

Trátala como una contraseña: no la subas a un repositorio público ni la dejes escrita en el código que compartes.

2. Autentica tus peticiones

Hay dos métodos. Por nuestra parte, te recomendamos el primero.

Método 1: cabecera Authorization (recomendado)

Incluye una cabecera Authorization con el valor Token YOUR_API_KEY. Es más segura porque la clave viaja en la cabecera y no queda registrada en la URL.

curl -X GET 'https://api.seranking.com/v1/account/subscription' \

  -H 'Authorization: Token YOUR_API_KEY'

Método 2: parámetro de consulta

Pasa la clave como parámetro apikey dentro de la propia URL. Rápido para pruebas, menos indicado para producción.

curl -X GET 'https://api.seranking.com/v1/account/subscription?apikey=YOUR_API_KEY'

3. Lanza tu primera petición

Nada mejor para comprobar que todo funciona que pedir los detalles de tu suscripción.

Si la clave es válida, recibes un 200 OK. Con cURL:

curl --location 'https://api.seranking.com/v1/account/subscription' \

  --header 'Authorization: Token YOUR_API_KEY'

El mismo caso en Python, que es donde empieza a verse el valor de automatizar.

Con la librería requests defines una pequeña función reutilizable que añade la cabecera por ti en cada llamada:

import requests

BASE_URL = "https://api.seranking.com"

API_KEY = "YOUR_API_KEY"

def se_ranking_get(endpoint, params=None):

    headers = {"Authorization": f"Token {API_KEY}"}

    respuesta = requests.get(f"{BASE_URL}{endpoint}", headers=headers, params=params)

    respuesta.raise_for_status()

    return respuesta.json()

# Petición de prueba

suscripcion = se_ranking_get("/v1/account/subscription")

print(suscripcion)

Esa función se_ranking_get te sirve para el resto de la guía: cambias el endpoint y los parámetros, y el patrón de autenticación se mantiene idéntico.

Dos apuntes técnicos antes de seguir:
Las peticiones GET llevan los parámetros en la URL.

• Las peticiones POST necesitan la cabecera Content-Type: application/json y envían los datos en un cuerpo JSON.
• Y el consumo se mide en créditos: cada endpoint tiene un coste por petición y, en algunos casos, un coste por registro devuelto.

Solo las respuestas correctas (código 2xx) consumen créditos; los errores 4xx y 5xx no se facturan.

Tenlo en cuenta cuando montes procesos que hagan miles de llamadas, porque marca la diferencia entre un flujo eficiente y uno que agota tu plan a media semana.

Casos de uso: automatiza tu SEO con código

Estos tres flujos están sacados de las guías rápidas oficiales de SE Ranking y usan endpoints reales de la Data API.

1. Caso de uso 1: encontrar brechas de palabras clave

El flujo clásico de análisis competitivo: mira el rendimiento global de un dominio, identifica a sus rivales y saca las keywords que se te escapan.

Empieza por la visión general mundial del dominio, que agrega estadísticas de búsqueda orgánica y de pago a escala global:

curl --location 'https://api.seranking.com/v1/domain/overview/worldwide?domain=tudominio.es&currency=EUR' \

  --header 'Authorization: Token YOUR_API_KEY'

Después, descubre contra quién compites de verdad en resultados orgánicos. El parámetro source selecciona la base de datos regional (usa es para España):

curl --location 'https://api.seranking.com/v1/domain/competitors?domain=tudominio.es&type=organic&source=es' \

  --header 'Authorization: Token YOUR_API_KEY'

Y ahora la parte jugosa: las keywords por las que un competidor posiciona y tú no. El endpoint de comparación con el parámetro diff=1 te devuelve justo ese hueco de contenido:

curl --location 'https://api.seranking.com/v1/domain/keywords/comparison?source=es&domain=competidor.es&compare=tudominio.es&type=organic&diff=1&order_field=volume&order_type=desc' \

  --header 'Authorization: Token YOUR_API_KEY'

En Python, apoyándote en la función de antes, sacar la lista de competidores se queda en tres líneas:

competidores = se_ranking_get(

    "/v1/domain/competitors",

    params={"domain": "tudominio.es", "type": "organic", "source": "es"},

)

for c in competidores:

    print(c)

¿Otras vías dentro del mismo flujo?

El endpoint domain/keywords con pos_change=lost te devuelve las keywords que has perdido (fruta madura para reoptimizar contenido antiguo), y keywords/similar amplía un término en variantes semánticas para construir clústeres temáticos.

Con esos cuatro endpoints tienes un mapa de oportunidades que a mano te llevaría toda una mañana.

2. Caso de uso 2: detectar URL con errores técnicos

Una auditoría técnica manual para varios sitios es un buen candidato a automatización.

La API te deja partir de una auditoría ya completada, leer el informe y extraer las URLs afectadas por cada problema.

Primero, recupera el informe completo.

Cada check tiene un código único (por ejemplo, http4xx para errores 4XX):

curl --location 'https://api.seranking.com/v1/site-audit/audits/report?audit_id=YOUR_AUDIT_ID' \

  --header 'Authorization: Token YOUR_API_KEY'

Con ese código, pide todas las URLs concretas afectadas por ese problema. Los parámetros limit y offset te sirven para paginar cuando hay muchos resultados:

curl --location 'https://api.seranking.com/v1/site-audit/audits/issue-pages?code=http4xx&audit_id=YOUR_AUDIT_ID&limit=100&offset=0' \

  --header 'Authorization: Token YOUR_API_KEY'

La respuesta llega estructurada y lista para volcar en un ticket o una hoja de trabajo:

{

  "total_urls": 28,

  "urls": [

    "https://example.com/missing-page/",

    "https://example.com/old-url/"

  ],

  "urls_type": "simple_urls_array"

}

El mismo paso en Python, integrado en tu flujo:

paginas = se_ranking_get(

    "/v1/site-audit/audits/issue-pages",

    params={

        "code": "http4xx",

        "audit_id": "YOUR_AUDIT_ID",

        "limit": 100,

        "offset": 0,

    },

)

print(f"URLs afectadas: {paginas['total_urls']}")

for url in paginas["urls"]:

    print(url)

A partir de aquí, montar un script que recorra todos los códigos de error de un informe y genere un CSV de tareas por cliente es cuestión de un bucle.

Ese es el salto de consultar datos a construir un proceso repetible.

3. Caso de uso 3: analizar la visibilidad en buscadores con IA

La API de AI Search permite estudiar la presencia de una marca en Google AI Overviews, AI Mode, ChatGPT, Gemini y Perplexity.

Uno de los quickstarts incluye un notebook de Google Colab que recopila los datos, compara marcas, calcula el share of voice y genera tablas, gráficos y archivos CSV.

También puede extraer los prompts que activaron menciones o enlaces hacia una marca.

Como ves, aparecer (o no) en las respuestas de los motores de IA se ha vuelto una métrica de negocio, y la Data API te deja consultarla de forma programática.

El endpoint ai-search/prompts-by-target devuelve los prompts en los que un dominio aparece dentro de un motor concreto. Con el parámetro engine=ai-overview filtras por AI Overviews de Google; también admite chatgpt, gemini, perplexity o ai-mode:

curl --location 'https://api.seranking.com/v1/ai-search/prompts-by-target?target=competidor.es&scope=domain&source=es&engine=ai-overview&limit=10' \

  --header 'Authorization: Token YOUR_API_KEY'

En Python:

prompts = se_ranking_get(

    "/v1/ai-search/prompts-by-target",

    params={

        "target": "competidor.es",

        "scope": "domain",

        "source": "es",

        "engine": "ai-overview",

        "limit": 10,

    },

)

Un truco de almendruco: lanza la consulta sobre un rival y revisa el array links de cada prompt.

Si tu dominio no aparece donde sí lo hace la competencia, tienes identificado un hueco de contenido para la búsqueda generativa.

Repite el proceso a diario o cada semana y tendrás un rastreador de visibilidad IA hecho a tu medida.
Si quieres más casos prácticos, los tienes en la página de Data API de SE Ranking.

Cómo automatizar SEO con la API

Para automatizar SEO necesitas algo más que una consulta que funcione.

El proceso debe seguir una estructura estable:

• Extracción: el script solicita los datos a la API.
• Transformación: limpia, ordena y filtra las métricas.
• Almacenamiento: guarda la información en un CSV, una hoja o una base de datos.
• Activación: actualiza un informe, crea una tarea o envía una alerta.
• Programación: ejecuta el flujo cada día, semana o mes.

Puedes programar un script con cron, GitHub Actions, un servidor propio o un servicio en la nube.

Otra opción es utilizar Make o n8n para lanzar la consulta y enviar los resultados a otras aplicaciones.

Empieza con una tarea concreta.

Por ejemplo: generar cada lunes un CSV con las palabras clave perdidas de cinco dominios.

Cuando el flujo sea estable, añade nuevas fuentes y acciones.

Intentar construir desde el primer día el centro de control definitivo del SEO mundial suele acabar con muchas pestañas abiertas y ninguna automatización en producción.

Consejos para trabajar con la API sin sustos

• Guarda la clave en una variable de entorno, no en el código.

Un simple

os.environ["SE_RANKING_KEY"] 

en Python te evita filtrarla al compartir un script o subirlo a Git.

• Controla el consumo de créditos antes de escalar.

Prueba tu lógica con limit bajos y amplía cuando el flujo funcione. Recuerda que los errores no gastan créditos, así que depurar sale gratis.

• Gestiona los errores desde el principio.

El raise_for_status() del ejemplo lanza una excepción si algo falla; envuélvelo en un try/except cuando el proceso corra desatendido, para que un fallo puntual no tumbe todo el script.

Preguntas frecuentes sobre la API de SE Ranking