Referencia
Comprobar backlinks online: acciones, costes y parámetros
Una referencia clara para las llamadas utilizadas en casos prácticos. Los costes se miden en créditos, y 1 crédito equivale a $0.0001. Cada llamada se factura una sola vez, independientemente del número de filas que devuelva.
Acciones agrupadas por precio
| Acción | Créditos | Úsalo para |
|---|---|---|
domain, overview, stats, suggest | Gratis, sin clave | Primera visión de un dominio, su puntuación y cifras clave |
bulk_dr | 1 | Evalúa hasta 2.000 dominios en una sola llamada (GET domains= o un cuerpo POST) |
compare | 1 | Compara hasta 20 dominios lado a lado |
top, dr_distribution, tld_breakdown | 1 | Analiza la estructura: líderes, distribución de puntuaciones y mezcla de TLD |
refdomains, backlinks | 2 | Lista quiénes enlazan a un sitio |
anchors, anchor_cloud, toppages | 2 | Analiza las palabras utilizadas y las páginas que atraen enlaces |
intersect | 2 | Encuentra referenciadores compartidos entre 2 y 10 dominios |
search | 3 | Búsqueda de texto completo en anclas, títulos y URLs |
keyword | 3 | Encuentra quiénes enlazan con una ancla exacta |
Solicita campos, uno a uno
Seis parámetros cubren casi todas las llamadas utilizadas en casos prácticos. Cada entrada indica qué hace el parámetro y dónde se detiene.
action
Nombra la llamada, como overview o intersect. Cada solicitud necesita una, y la acción determina el precio.
q
El dominio bajo examen, escrito sin protocolo, para acciones de un solo dominio como overview y refdomains.
domains
Una lista separada por comas para acciones con múltiples dominios. intersect acepta de 2 a 10 dominios, compare hasta 20, y bulk_dr hasta 2.000 mediante GET o en un cuerpo POST.
key
Tu clave sk_, pasada como parámetro o como cabecera Authorization: Bearer. Las acciones gratuitas se ejecutan sin ella.
page y per
page avanza por los resultados y per establece filas por página, de 10 a 5000. La paginación profunda se detiene en 50.000 filas, así que acota la pregunta antes de paginar tanto.
sort y order
sort nombra la columna y order acepta asc o desc. Ordenar dominios de referencia por puntuación ascendente trae los más delgados al principio, donde suelen aparecer las huellas.
Parámetros que reutilizarás
La autenticación es un parámetro key o una cabecera Authorization: Bearer sk_.... Mantén las claves fuera de las URLs que pegues en chats, porque las cadenas de consulta terminan en los registros. CORS es abierto, por lo que una herramienta del navegador funciona tan bien como un script. Muy útil.
La paginación usa page y per, donde per varía de 10 a 5000. Simple. Una sola llamada devuelve hasta 1.000 filas, y la paginación profunda está limitada a 50.000. La ordenación usa sort más order=asc o order=desc.
Coloca la cola barata primero. Ordenar dominios de referencia por puntuación ascendente pone los dominios delgados en la parte superior, donde aparecen las huellas. Este solo hábito ahorra una hora.
Mantén los parámetros en el mismo orden siempre. Un orden fijo facilita comparar dos direcciones guardadas a simple vista y evita que un diff se llene de ruido.
Presupuesta una llamada antes de ejecutarla
El precio sigue a la acción, no al número de filas. Esa es la regla. Una llamada refdomains cuesta 2 créditos, ya sea que devuelva un puñado de filas o una página completa. Multiplica el precio por el número de llamadas que planeas, no por las filas que esperas ver.
Escribe el plan antes de la primera llamada. Una breve lista de acciones, dominios y llamadas esperadas es suficiente. Convierte una factura sorpresa en una pregunta. Resuélvela pronto.
Por llamada, no por fila
Cada llamada se factura una sola vez. Paginar una lista larga es un cargo por página solicitada, por lo que un valor per mayor puede reducir el número de cargos en una extracción larga. Lee _credits después de la primera página para confirmar el precio antes de bucle. Cada página de una extracción paginada es una llamada separada, así que cuenta las páginas antes de empezar y mantén per igual en todas.
Asigna el coste a la decisión
Sopesa el precio de una respuesta frente a lo que cambiará esa respuesta. Una verificación de puntuación que podría alterar una compra justifica una extracción pagada. La curiosidad pasajera sobre un rival rara vez lo hace. Mantén la decisión y los créditos gastados en la misma nota.
Llamadas gratuitas como filtro
Ejecuta primero domain, overview y stats. No cuestan nada y muestran si vale la pena hacer una extracción pagada. Imagina un dominio cuya vista general muestra casi ningún dominio de referencia. Es posible que no necesites refdomains en absoluto, y los créditos ahorrados puedan ir a un rival. El método de red usa el mismo filtro.
El saldo de la cuenta
El saldo aparece en _credits en cada llamada con clave. Léelo después de cada ejecución y copia la cifra junto al archivo guardado. Una llamada que devuelve HTTP 402 significa que se han agotado los créditos, así que recarga antes de la siguiente ejecución.
Respuestas y errores
| Lo que obtienes | Significado | Qué hacer |
|---|---|---|
ok en cada respuesta | La bandera para probar antes de leer cualquier otra cosa | Ramifica en tu script según este valor |
_credits en llamadas con clave | Coste de esta llamada y tu saldo restante | Regístralo junto al documento |
| HTTP 401 | Clave faltante o incorrecta | Verifica la cabecera o el parámetro key |
| HTTP 402 | Se han agotado los créditos | Recarga con USDT (TRC-20) en la página de la cuenta |
Aspecto de una extracción finalizada
Una extracción finalizada para comprobar backlinks online es más que un archivo JSON. Lleva una fecha, la llamada, la ventana y una nota de lo que no puede mostrar. Mantén los cuatro juntos. De lo contrario, el archivo vale menos cada mes.
El cuerpo crudo
Guarda la respuesta exactamente como llegó, antes de cualquier filtrado u ordenación. Un resumen que escribas tú mismo solo puede verificarse contra el archivo crudo, por lo que ese es el que debes conservar.
Los parámetros
Registra la acción, el dominio o lista, los valores de paginación y el orden de ordenación. Dos extracciones que difieren solo en per no son comparables hasta que esa diferencia se anote.
La ventana
Indica el ciclo de actualización del que provienen las cifras y el día en que las obtuviste. Una cifra sin fecha será refutada con un número más reciente, y el argumento girará entonces alrededor de la fecha en lugar del hallazgo.
Los límites
Escribe una línea sobre lo que la llamada no pudo ver: enlaces añadidos después de la última actualización, páginas bloqueadas para los rastreadores, enlaces detrás de un inicio de sesión. La línea evita que un hallazgo reclame más de lo que sus datos pueden soportar.
Paginar una lista larga sin desperdicio
La paginación es donde los presupuestos desaparecen silenciosamente. Cada página es otra llamada, y una lista larga extraída página por página puede costar más de lo que vale la pregunta. Dos hábitos la mantienen honesta.
Ordena antes de paginar
Ordena por la columna que responda a tu pregunta, luego pagina a través del resultado. La primera página debería contener las filas sobre las que actuarías. Si no es así, cambia la ordenación antes de gastar más llamadas.
Detente cuando la pregunta esté respondida
Una lista de decenas de miles de filas rara vez es la respuesta. Deja de paginar una vez que las filas que necesitas estén en pantalla, guarda esa página y anota dónde te detuviste. La nota indica al siguiente lector qué se omitió. Deja el resto sin leer a menos que cambie la pregunta.
Errores sobre los que puedes actuar primero
Dos códigos de estado explican la mayoría de las ejecuciones detenidas. Cada uno tiene una solución que toma menos tiempo que adivinar la causa.
HTTP 401 primero, siempre
Un 401 significa que falta o es incorrecta la clave, así que verifica la cabecera o el parámetro antes de cualquier otra cosa. Copia la clave desde la página de la cuenta en lugar de volver a escribirla, ya que un solo carácter equivocado produce el mismo error. Si las llamadas gratuitas funcionan y las pagadas fallan, la clave es la causa más probable, porque las acciones gratuitas no necesitan clave en absoluto.
HTTP 402 en medio de una ejecución
Un 402 detiene una ejecución que funcionaba hace un minuto. Detén el bucle, lee el saldo y recarga antes de la siguiente llamada. No reintentes en un bucle cerrado, porque cada reintento es una solicitud que no puede tener éxito hasta que cambie el saldo.
Antes de confiar en una respuesta
- Verifica que
oksea true - Anota la fecha, porque el índice se actualiza aproximadamente cada mes
- Recuerda que DR es round(100 · log(ref_domains + 1) / log(2·10^7)), no un número de terceros
- Compara dominios de referencia entre herramientas, no totales brutos de backlinks
- Archiva el archivo crudo, no solo tu resumen
Límites, declarados claramente
Estos son datos de enlaces a un precio bajo por llamada. No rastrea palabras clave. Tampoco rastrea posiciones. Ahrefs y Semrush son productos más completos para eso, y Ahrefs vende unidades de API dentro de suscripciones a partir de $129 al mes por 200.000 unidades.
Las recetas que usan estas llamadas están en casos prácticos con curl, y los términos desconocidos están en el glosario.
Leer una respuesta con escepticismo
Una respuesta es un testimonio. Es verdadero según el índice del día del rastreo, y calla sobre todo lo que está fuera de él. Pregunta qué no pudo haber visto el índice: páginas bloqueadas por robots.txt, enlaces añadidos después de la última actualización, enlaces detrás de un inicio de sesión. Si quieres comprobar backlinks online sin escribir código, el comprobador en la página principal llama a la acción gratuita domain.
Cruza una cosa a mano cada vez. Elige un referenciador único de la lista, abre la página y busca el enlace. Simple. Si está ahí, confía un poco más en el resto. Si no, anota la fecha y la URL, y consulta la tabla de solución de problemas.
Nunca dejes que un script actúe sobre una sola lectura. La alerta está bien, pero eliminar enlaces, enviar archivos de desavow o contactar con los propietarios debe esperar a un humano.
