Ir al contenido
Anchor Social
Anchor SocialRegistrarse

Solución de problemas

¿Cómo verificar backlinks por API cuando las filas parecen incorrectas?

Una tabla basada en síntomas para los momentos en que una extracción de anchors devuelve menos filas de las esperadas, cuesta más de lo planeado o difiere del mes anterior.

Cuatro tuberías de arcilla alimentando un tazón que representa errores de datos de API y enlaces bloqueados

Verifica estas tres cosas primero

La mayoría de las extracciones extrañas se remontan a una de tres causas. Cada una de esas puede verificarse en menos de un minuto, lo que hace sensato descartarlas antes de que alguien pase una hora con las filas. Verifica esas tres: la clave, el saldo de créditos o la fecha de la instantánea.

Cada respuesta autenticada contiene ok y un objeto _credits con el costo y el saldo restante, por lo que el primer paso es siempre imprimir esos dos campos. Comienza ahí, siempre. Si ok es falso, nada de lo que digan las filas importa aún.

Luego verifica el mes. Nuestro índice se actualiza aproximadamente una vez al mes, y un enlace añadido la semana pasada simplemente puede no estar en él, lo cual no es un error.

Otro hábito más. Mantén una línea de registro por llamada con la acción, el número de página y el saldo restante de _credits; esto facilita rastrear 7 créditos faltantes más tarde en lugar de tener un misterio a fin de mes.

Síntoma, causa, solución

SíntomaCausa probableSolución
HTTP 401Falta o error en la claveEnvía key=sk_... o Authorization: Bearer sk_...; cópiala nuevamente desde la página de la cuenta
HTTP 402Se han agotado los créditosRecarga en USDT (TRC-20) desde la página de la cuenta y reintenta
Menos filas de lo que sugiere el totalUna llamada devuelve hasta 1.000 filasAñade page=2, page=3; la paginación profunda se detiene en 50.000 filas
El costo parece superior a 2 créditosSe llamó a una acción diferenteanchors cuesta 2 créditos; keyword y search cuestan 3; verifica el valor de action
El total difiere del mes anteriorEl índice se actualizóCompara instantáneas solo dentro de la misma herramienta y ciclo mensual
Falta un enlace nuevoEl enlace apareció después de la última actualizaciónEspera la próxima actualización mensual; no vuelvas a extraer para perseguirlo
La cuota de marca salta de repenteEnlaces sitewide añadieron muchas filasRecalcula por dominio enlazado, consulta el manual de ejecución
Números diferentes de Ahrefs o SemrushDiferentes rastros y fechas de actualizaciónElige una fuente para tendencias; usa la otra para verificaciones puntuales

Leer correctamente un resultado corto

Un dominio pequeño puede simplemente tener pocos anchors. Un dominio registrado recientemente, o que tenga pocas páginas con enlaces externos, puede producir una lista corta por razones perfectamente ordinarias. Corto no significa roto. No toda lista corta es un fallo.

Compara el recuento de filas con las cifras gratuitas de overview para el mismo dominio: si overview reporta miles de backlinks y anchors devuelve cuarenta filas en la página uno, probablemente necesites la página dos, no un ticket de soporte. Si overview mismo reporta un puñado, el dominio es joven o pequeño y la extracción es correcta. Cuenta primero, luego quejate.

También ocurre lo contrario. Los dominios enormes alcanzan el límite de paginación de 50.000 filas, así que ordena por la columna que te interese y toma la porción superior, o llama a anchor_cloud primero para ver qué términos dominan antes de navegar por todo.

Engranajes de arcilla entrelazados de varios tamaños mostrando cómo las configuraciones afectan los resultados

La configuración de orden y paginación cambia lo que ves

Dos extracciones pueden diferir por una razón que no tiene nada que ver con la web. Orden, dirección y tamaño de página actúan juntos, por lo que cambiar uno de ellos puede reordenar todo el resultado incluso cuando el dominio y la clave permanecen exactamente iguales. El orden, la dirección y el tamaño de página deciden qué filas van primero y cuántas llegan por llamada. Verifica eso primero.

Mismo dominio, diferentes líderes

Las primeras filas siguen el orden que solicitaste, por lo que un archivo ordenado de una manera no se verá como un archivo ordenado de otra. El orden cambia los líderes. Si un archivo lidera con los sitios que más refieren y el siguiente lidera con las filas más nuevas, ambos pueden ser correctos. Nota el orden en el nombre del archivo.

Una prueba rápida ayuda. Ejecútala primero en un dominio pequeño, para que la prueba cueste casi nada y dé una respuesta clara sobre la solicitud. Llama a la misma acción dos veces con parámetros idénticos. Si las filas coinciden, la diferencia radica en la solicitud, no en los datos.

La página dos no es una copia de la página uno

Cada página es su propia llamada con su propia línea de facturación, y las filas de una página no deberían repetirse en la siguiente. Las páginas son llamadas separadas. Cuando lo hacen, probablemente el bucle mantuvo el mismo valor de página. Imprime el primer dominio de cada página para confirmar que los números cambian.

Mantén el número de página en tu registro junto al saldo. Un bucle que se estanca en la página dos es mucho más fácil de arreglar cuando puedes ver la llamada exacta que se detuvo. Los registros ahorran horas.

Prueba dos páginas primero. Una prueba corta después de las primeras dos páginas es suficiente. Si la página dos repite la página uno, detén el bucle antes de que el saldo pague por las mismas filas dos veces.

Imprime los campos de facturación antes que nada

Una guardia de tres líneas que puedes pegar en un script cron.

bash
R=$(curl -s "https://anchorsocial.org/api.php?action=anchors&q=example.com&per=1000&key=$KEY")
echo "$R" | jq '{ok, _credits}'
[ "$(echo "$R" | jq -r .ok)" = "true" ] || exit 1

Reparar el orden cuando una extracción parece incorrecta

Trabaja de arriba hacia abajo. Cada paso elimina una familia de causas antes de que comience la siguiente.

  1. 1

    Confirma que la llamada tuvo éxito

    Lee ok en la primera respuesta. Si es falso, las filas aún no importan.

  2. 2

    Compara los parámetros

    Verifica action, q, sort, order, per y page contra el archivo con el que estás comparando.

  3. 3

    Verifica la fecha del índice

    Pregunta si una actualización mensual cayó entre las dos extracciones, y escribe esa fecha en la hoja.

  4. 4

    Reconstruye la solicitud desde cero

    Escribe la llamada de nuevo, parámetro por parámetro, para atrapar un error tipográfico que una URL copiada puede ocultar.

Sobres de arcilla bajo una lupa mostrando diferencias sutiles para la resolución de disputas

Resolver una disputa con el archivo del mes anterior

Cuando dos archivos discrepan, la pregunta rara vez es quién tiene razón. La mayoría de las discrepancias son causadas por un cambio en una configuración que nadie anotó, por eso el registro importa más que la memoria. Se trata de qué parte de la solicitud cambió entre ellos. Mira la solicitud primero. Trabaja a través de tres verificaciones en orden, y la mayoría de las disputas terminan en la primera.

Comienza con la fecha del índice

El índice se actualiza aproximadamente una vez al mes, y esa actualización es lo primero que se debe descartar. Un enlace que se activó después de la última actualización no aparecerá en ningún archivo, y volver a extraer el mismo día no solucionará eso. Las fechas de actualización explican las brechas.

Etiqueta cada archivo. Un archivo nombrado con su fecha de extracción y su ciclo de actualización responde la pregunta más común antes de que alguien tenga que hacerla en una reunión. Escribe el ciclo de actualización junto a cada nombre de archivo. Luego, una brecha se lee como una brecha en el tiempo, no como una brecha en la web.

Mantén las fechas de actualización juntas en una columna, no dispersas en notas. Un lector que ve las fechas junto a los totales rara vez necesita hacer una segunda pregunta. Eso ahorra una pregunta.

Compara lo similar con lo similar

Dos archivos son comparables solo cuando la acción, el dominio, el orden y el valor per coinciden. Si el orden difiere, las filas principales diferirán incluso cuando todos los totales coincidan, y eso puede parecer un cambio real en el perfil. Mezclar un archivo de anchors con un archivo de backlinks es una forma común de inventar una caída que nunca ocurrió. La coincidencia de configuraciones es lo primero.

Si los parámetros coinciden y los totales aún difieren, esa diferencia vale la pena un examen más cercano, y el registro te dice dónde comenzar. Luego lee el registro.

Dale al valor per su propia columna también, porque cambia cuántas filas llegan por llamada y por lo tanto cuántas llamadas cuesta una extracción. Manténlo visible.

Cuando las filas se movieron en lugar de desaparecer

Después de un cambio de dominio o un rediseño, un enlace puede seguir existiendo y apuntar a una nueva dirección. Los hosts antiguos mantienen enlaces. Compara las páginas principales para el host antiguo y el nuevo antes de llamar al enlace perdido. La lista de verificación de migración pasa por esa combinación.

Registra ambos lados. Registra ambas direcciones en una línea, para que el movimiento permanezca visible en la hoja.

Costos que sorprenden a la gente

Una factura que crece más rápido que el plan usualmente tiene una causa. Muchos equipos notan una factura más alta solo a fin de mes, por lo que una revisión semanal del total acumulado atrapa la deriva más temprano. Es la acción. Muchos lectores preguntan cómo verificar backlinks sin gastar de más, y la respuesta comienza con el nombre de la acción. Lee el saldo en cada respuesta y mantén un total acumulado junto a tu hoja.

Un saldo que se agota más rápido de lo planeado

Los nombres de las acciones importan. El culpable habitual es el nombre de la acción. anchors cuesta 2 créditos, mientras que keyword y search cuestan 3 cada uno, por lo que un script que cambió de acciones elevó silenciosamente la factura. Verifica el valor de action en la solicitud antes de la primera ejecución grande.

Rastrea la deriva. Mantén un total acumulado de _credits en la hoja. Una pequeña deriva cada día es fácil de ver allí, mucho antes de que termine el mes.

Un 402 a mitad de un bucle

Un 402 significa que se agotó el saldo. Detén el bucle. Las llamadas que ya fueron servidas han sido facturadas, mientras que la siguiente llamada falla. Detén el bucle, recarga en USDT (TRC-20) desde la página de la cuenta y reanuda desde la página en la que te detuviste.

Un punto de reanudación solo es útil cuando se anota. Mantén el número de página en el registro, para que el reinicio no sea una suposición. Escribe la página.

Leer un resultado demasiado grande

Un recuento que crece de repente merece un vistazo a la fuente antes de convertirse en una historia. Un solo enlace de plantilla puede añadir miles de filas, y una línea de totales sola no te dirá si eso es un sitio o muchos. Las filas pueden ser correctas, y la razón puede residir en un dominio en lugar de en todo el perfil. Verifica la fuente primero.

Un footer sitewide detrás de un recuento grande

Un enlace de plantilla que aparece en miles de páginas de un solo sitio puede representar un bloque grande de filas. Agrupa la extracción por dominio enlazado y ve cuánto del total sostiene un sitio. Agrupa primero, luego juzga.

Si un dominio domina, el total es un hecho sobre ese sitio, y el análisis debe enmarcarse de esa manera. Encuadrarlo de esa manera.

Filas de un dominio que nunca enlazaste

Anchors extraños necesitan verificación. Su presencia no prueba que algo esté mal, pero sí significa que la fila merece la misma lectura que cualquier otra fila en tu análisis. Dominios de enlace desconocidos con anchors no relacionados pueden provenir de un scraper o una página comprometida. Abre una de las páginas de enlace, como lo haría un visitante, antes de asumir que las filas pertenecen a tu perfil.

Registra el dominio, la fecha y el anchor en la hoja, y conserva la respuesta raw, para que una revisión posterior tenga la evidencia. La evidencia supera a la memoria.

Si la tabla no lo resolvió

  • Ejecuta una acción gratuita como overview para el mismo dominio; si eso funciona, el problema es la clave
  • Confirma que escribiste el dominio desnudo en q, sin una ruta
  • Guarda el JSON raw antes de cambiar cualquier cosa
  • Verifica el saldo en el dashboard contra _credits
  • Contáctanos desde tu página de cuenta con la acción y una marca de tiempo

Respuestas rápidas

¿Una llamada fallida cuesta créditos?

Un 401 o 402 devuelve antes de que se sirvan filas. Cada llamada exitosa se factura una vez, independientemente del recuento de filas hasta 1.000 filas. Verifica _credits en la respuesta para confirmar cuánto costó una llamada dada.

¿Por qué dos extracciones el mismo día diferirían?

No deberían, porque el índice solo cambia en su actualización mensual. Si lo hacen, compara primero los parámetros de orden y página, luego tu clave y la acción. La página de verificador gratuita cubre lo que devuelven las llamadas sin clave.