Ir al contenido
SEOCheck
SEOCheckRegistrarse

Documentación

Referencia de endpoints y precios

Una URL, muchas acciones. Esta es toda la superficie.

Equipo de investigación de SEOCheck ·

Un puente de piedra sólido que cruza un valle brumoso que representa un endpoint de API fiable

Acciones y costes

AcciónCréditosQué devuelve
domaingratisRegistro básico y DR para un dominio
overviewgratisResumen del perfil de enlaces de un dominio
statsgratisEstadísticas a nivel de índice
suggestgratisSugerencias de dominios mientras escribes
bulk_dr1DR para hasta 2.000 dominios
compare1Comparación lado a lado para hasta 20 dominios
top1Dominios principales
dr_distribution1Distribución de DR entre dominios que enlazan
tld_breakdown1Enlaces por dominio de nivel superior
refdomains2Dominios de referencia
backlinks2Backlinks individuales
anchors2Textos de anclaje
toppages2Páginas más enlazadas
anchor_cloud2Pesos de anclaje
intersect2Enlazadores compartidos para 2 a 10 dominios
search3Búsqueda de texto completo sobre anclas, títulos y URLs
keyword3Quién está enlazado con una ancla exacta

Autenticación y formato

URL base: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... ¿Prefieres encabezados? Envía Authorization: Bearer sk_... en su lugar.

Esta API de análisis de backlinks responde en JSON y permite llamadas cross-origin, por lo que un navegador puede acceder directamente. Cada respuesta tiene un campo ok. Las respuestas autenticadas también incluyen _credits, que contiene el coste de esa llamada y tu saldo restante.

Los errores son contundentes. HTTP 401 significa que falta la clave o es incorrecta. HTTP 402 significa que se agotó el saldo. Ambos son fáciles de gestionar y ninguno debe reintentarse en bucle.

Antes de la primera llamada de pago

  • Ejecuta overview en un dominio que conozcas. Es gratis.
  • Comprueba que tu clave funciona con una llamada de 1 crédito como compare.
  • Lee _credits en la respuesta y confirma que el coste coincide con la tabla anterior.
  • Configura una alarma en el script para HTTP 402 para que un saldo agotado no falle en silencio.

Paginación y ordenación

Las filas por llamada pueden llegar a 1.000. Solicita menos o más con per, de 10 a 5000, navega con page y ordena con sort y order.

bash
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Un jardinero podando cuidadosamente un bonsai con tijeras especializadas que ilustra ajustes precisos

Parámetros que cambian la respuesta

Cada acción toma los dos básicos, action y q, y luego un conjunto corto de opciones. Léelas primero. La mayoría de los errores provienen de opciones que parecen opcionales pero cambian el coste o la forma de las filas. Lee las opciones antes de copiar una llamada de un foro o un blog.

Los ejemplos a continuación asumen una clave en el parámetro key. Reemplaza el marcador con la tuya. Mantén la clave en una variable de entorno, no en un archivo que hagas commit. Cada ejemplo en esta referencia de API de backlinks utiliza la misma URL base.

Paginación con page y per

La opción per establece cuántas filas se devuelven, de 10 hasta 5000. La opción page te mueve a través del conjunto. Una llamada que pide 500 filas y luego page 2 devuelve el siguiente bloque, no la siguiente extracción de las mismas filas.

La paginación profunda se detiene en 50.000 filas. Si un trabajo necesita más que eso, estrecha la consulta con sort o divide el trabajo por dominio, para que cada llamada se mantenga dentro del límite.

Ordenación con sort y order

Ordena en el servidor, no en tu script. Pedir sort=dr&order=desc devuelve primero los dominios que enlazan con mayor fuerza, para que las filas que te interesen lleguen en la primera página. Filtrar después de descargar todo desperdicia tiempo y créditos.

Usa order=asc cuando quieras las filas más débiles, por ejemplo para encontrar enlaces escasos o detectar una caída repentina en un perfil.

Listas: bulk_dr, compare e intersect

Las acciones de lista toman varios dominios en una llamada. bulk_dr acepta hasta 2.000 dominios por un crédito, con una cadena de consulta GET o un cuerpo POST. compare toma hasta 20 dominios, e intersect toma de dos a diez.

Dado que el precio no depende del número de filas, una lista larga en una llamada es más barata que muchas llamadas cortas. Digamos que revisas 1.500 sitios prospecto el lunes. Eso es una llamada, no 1.500.

Las llamadas de búsqueda y keyword cuestan más

La acción search realiza una búsqueda de texto completo sobre anclas, títulos y URLs. La acción keyword pregunta quién está enlazado con una ancla exacta. Ambas cuestan tres créditos por llamada, así que úsalas para responder una pregunta específica en lugar de navegar.

Elegir per y page para una primera extracción

Para una primera vista de un nuevo dominio, comienza con un per pequeño, como 50. Verás la forma de las filas, los nombres de los campos y el coste en una respuesta corta. Aumenta per solo cuando sepas que las filas son lo que necesitas. El mismo hábito funciona para cada acción en la tabla anterior.

Un error común es solicitar 5000 filas en el primer intento y luego descartar la mayoría. La respuesta es más grande, la espera es más larga y el ahorro que esperabas no aparece.

Leyendo el medidor de créditos

Cada respuesta autenticada termina con _credits, que da el coste de esa llamada y tu saldo después de ella. Regístralo. Súmalos al final del mes y conocerás tu factura real hasta el centavo.

Un presupuesto aproximado ayuda. Mil llamadas refdomains cuestan 2.000 créditos, que son $0.20. Mil llamadas search cuestan 3.000 créditos, o $0.30. Una ejecución diaria bulk_dr en una lista de 2.000 dominios cuesta 1 crédito, así que aproximadamente $0.003 por mes.

En comparación con planes que comienzan en $129 por mes para 200.000 unidades de API, como los lista Ahrefs, la forma de la factura es diferente. Consulta la comparación para ver cómo.

Un par de balanzas de latón vintage equilibrando dos pesos distintos que representan diferentes tipos de error

Leyendo errores y el campo _credits

Una respuesta puede fallar de dos maneras diferentes, y tu código debe tratarlas de forma distinta. Son problemas diferentes. Una clave incorrecta es un problema de configuración. Un saldo vacío es un problema de facturación. Manejar ambos como un error genérico oculta qué solución necesitas.

Lee primero el campo ok. Luego lee el bloque _credits. Solo después deberías mirar las filas, porque un resultado faltante o corto es más fácil de explicar cuando ya sabes cuánto costó la llamada.

Maneja 401 y 402 por separado

HTTP 401 significa que falta la clave o es incorrecta. Detén el trabajo y corrige la clave. HTTP 402 significa que se gastó el saldo. Recarga desde la página de la cuenta y continúa. Reintentar un 401 nunca ayuda, y reintentar un 402 sin recargar tampoco ayuda.

Registra el saldo antes y después de una ejecución

Anota el saldo _credits al inicio de una ejecución y al final. La diferencia debe coincidir con lo que esperabas de las llamadas que realizaste. Un salto mayor significa que un bucle se ejecutó más veces de lo previsto.

Para una verificación rápida, multiplica el número de llamadas por su coste en créditos. Si la respuesta es 40 y el saldo bajó 4.000, algo está mal con el script, no con la lista de precios.

Verifica las filas que solicitaste

Una respuesta exitosa con menos filas de las esperadas no es automáticamente un error. Un dominio pequeño puede simplemente tener pocos enlaces. Compara el número de filas con el valor per que enviaste y trata una brecha como una pregunta a responder, no como un fallo a ocultar.

Prueba primero las llamadas baratas

Antes de conectar una llamada a un trabajo, ejecútala una vez manualmente con las opciones más pequeñas sensatas. Verifica la respuesta, los nombres de los campos y el valor _credits. Un trabajo que falla en la segunda fila es mucho más difícil de depurar que una llamada que falló en su primer intento.

Una primera sesión con la API

Cuatro llamadas, en orden, para que cada llamada posterior sea una que ya entiendes. Solo la primera es gratuita, y eso es intencional.

01

Ejecuta overview en un dominio que conozcas

Es gratis y no necesita clave. Compara el resumen con lo que ves en la search console y en el sitio mismo, para que sepas cómo se ve una respuesta normal.

02

Prueba la clave con una llamada de 1 crédito

Envía compare con tu dominio y un rival. Confirma que el campo ok es verdadero y que _credits muestra un coste de un crédito.

03

Extrae una lista de 2 créditos con un per pequeño

Pide refdomains con per=50 y sort=dr. Verifica que el número de filas y el coste en créditos coincidan con la tabla anterior.

04

Escribe el coste en tu registro

Registra el saldo antes y después. A partir de ahora, cada script que escribas comenzará con ese hábito, y una factura sorpresa se convertirá en una línea en un registro en lugar de un misterio.

Precios

Créditos prepagados. Un crédito es $0.0001. No hay suscripción ni mínimo mensual.

Acciones gratuitas

$0

  • domain, overview, stats, suggest
  • No se necesita clave
  • Alimenta el verificador web
Abrir el verificador

Paga según uso

$0.10por cada 1.000 llamadas de un crédito

  • $100 de crédito gratis al registrarse
  • No se necesita tarjeta
  • Recarga con USDT (TRC-20)
  • Facturado una vez por llamada, no por fila
Obtén $100 gratis

Límites que debes conocer

El índice cubre 181.132.097 dominios y 2.774.625.913 enlaces de dominio. Se actualiza aproximadamente mensualmente. Eso es más lento que un rastreo diario.

La paginación profunda se detiene en 50.000 filas. Para extracciones más grandes, estrecha la consulta con sort o divide por dominio.

El inicio de sesión es solo de Google, y las recargas son en USDT. Comienza con el verificador DR, prueba una auditoría de competidores con la guía de competidores, o lee por qué algunos equipos abandonan la API de Ahrefs para trabajo puro de enlaces.

Preguntas frecuentes

¿Pago por fila?

No. Una llamada se factura una vez, ya devuelva 10 filas o 1.000.

¿Qué sucede cuando se agotan los créditos?

La API devuelve HTTP 402. Recarga con USDT (TRC-20) desde la página de la cuenta y continúa.

¿Dónde encuentro mi clave?

En el panel después del inicio de sesión con Google.