Documentación
Referencia de endpoints y precios
Una URL, muchas acciones. Esta es toda la superficie.
Equipo de investigación de SEOCheck ·

Acciones y costes
| Acción | Créditos | Qué devuelve |
|---|---|---|
| domain | gratis | Registro básico y DR para un dominio |
| overview | gratis | Resumen del perfil de enlaces de un dominio |
| stats | gratis | Estadísticas a nivel de índice |
| suggest | gratis | Sugerencias de dominios mientras escribes |
| bulk_dr | 1 | DR para hasta 2.000 dominios |
| compare | 1 | Comparación lado a lado para hasta 20 dominios |
| top | 1 | Dominios principales |
| dr_distribution | 1 | Distribución de DR entre dominios que enlazan |
| tld_breakdown | 1 | Enlaces por dominio de nivel superior |
| refdomains | 2 | Dominios de referencia |
| backlinks | 2 | Backlinks individuales |
| anchors | 2 | Textos de anclaje |
| toppages | 2 | Páginas más enlazadas |
| anchor_cloud | 2 | Pesos de anclaje |
| intersect | 2 | Enlazadores compartidos para 2 a 10 dominios |
| search | 3 | Búsqueda de texto completo sobre anclas, títulos y URLs |
| keyword | 3 | Quié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
overviewen un dominio que conozcas. Es gratis. - Comprueba que tu clave funciona con una llamada de 1 crédito como
compare. - Lee
_creditsen 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.
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'
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.

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.
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.
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.
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.
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
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
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.