Referencia
Referencia: cada acción, su coste y cómo falla
Mantén esto abierto mientras escribes tu script de auditoría. Enumera las acciones, los precios, los límites de paginación y los dos errores que probablemente encuentres.
Conceptos básicos antes de las tablas
El endpoint es https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Puedes enviar la clave como cabecera Bearer. CORS está abierto, por lo que un script desde el navegador también funciona.
Cada respuesta tiene un indicador ok. Las respuestas autenticadas también incluyen _credits, que indica el coste y tu saldo restante. Esto hace que el seguimiento del presupuesto sea trivial.
En comparación con la tarifa de la API de Moz para backlinks, la estructura es diferente: Ahrefs vende unidades dentro de suscripciones a partir de $129 al mes por 200.000 unidades, mientras que aquí pagas por llamada desde un saldo prepagado.
No hay niveles de suscripción que escalar ni mínimos mensuales. Un saldo prepagado significa que no hay facturas por excedentes. Una regla se aplica a todos. Un script que se ejecuta una vez al mes y un script que se ejecuta en cada incorporación de cliente pagan bajo la misma regla. Los nuevos registros comienzan con $100 en crédito gratuito, suficiente para aproximadamente 500.000 llamadas de dos créditos.
Escribir tu primer script sin sorpresas
Empieza con poco. Un script que llama a la API es fácil de escribir y fácil de sobrepasar. Las siguientes reglas mantienen la primera versión honesta.
Limita la primera ejecución a un dominio. Una vez que la salida parezca correcta, amplía la lista por pasos y lee el saldo entre cada paso.
Las páginas son la unidad de coste
Una llamada se factura una vez, independientemente del número de filas que devuelva. Una página que obtienes es otra llamada, por lo que navegar por una lista grande cuesta una carga por página.
Digamos que un sitio tiene 2.500 dominios de referencia y quieres todos. Con el tamaño de página que elijas, eso es un puñado de llamadas, y cada una tiene su propio coste. Cuenta las páginas antes de iniciar el bucle. Elige un tamaño de página que se ajuste a la pregunta, ya que una lista corta necesita una llamada y una larga requiere el mismo cuidado en cada página.
Lee los créditos en cada respuesta
Cada respuesta autenticada incluye _credits, que indica cuánto costó la llamada y cuánto queda. Registra ese campo en lugar de un número que hayas estimado mentalmente.
Un script que escribe el saldo en su salida te permite detenerse antes de que una ejecución larga agote la cuenta. Mantén la comprobación simple y visible.
Usa las llamadas gratuitas para probar el plan
domain, overview, stats y suggest no requieren clave y no cuestan nada. Úsalos para confirmar la ortografía del dominio y la forma básica de los datos antes de que se ejecute cualquier llamada de pago.
Solo entonces añade las llamadas de pago, una a una, contra el mismo dominio. Un error capturado en una llamada gratuita no cuesta nada. Guarda las salidas gratuitas en la misma carpeta con fecha que las de pago.
Acciones gratuitas y de un crédito
| Acción | Coste | Para qué sirve |
|---|---|---|
| domain | Gratuito | Búsqueda rápida de DR, la llamada detrás del comprobador en la página de inicio |
| overview | Gratuito | Números principales para un dominio |
| stats | Gratuito | Cifras sobre el índice en sí |
| suggest | Gratuito | Búsqueda tipo autocompletado de dominios |
| bulk_dr | 1 crédito | Hasta 2.000 dominios por llamada, GET con domains= o un cuerpo POST |
| compare | 1 crédito | Hasta 20 dominios lado a lado |
| top | 1 crédito | Una lista clasificada de nuestro índice |
| dr_distribution | 1 crédito | Cómo se distribuye DR en un conjunto |
| tld_breakdown | 1 crédito | Referenciadores agrupados por TLD |
Acciones de dos y tres créditos
| Acción | Coste | Para qué sirve |
|---|---|---|
| refdomains | 2 créditos | Dominios que enlazan a un objetivo |
| backlinks | 2 créditos | Enlaces individuales |
| anchors | 2 créditos | Lista de anchor text |
| toppages | 2 créditos | Páginas que atraen enlaces |
| anchor_cloud | 2 créditos | Palabras de anchor text ponderadas por uso |
| intersect | 2 créditos | Quien enlaza a 2-10 dominios a la vez, para búsqueda de enlaces de reemplazo |
| search | 3 créditos | Búsqueda de texto completo sobre anchors, títulos y URLs |
| keyword | 3 créditos | Quien está enlazado con un anchor exacto |
Una llamada se factura una vez, independientemente del número de filas, hasta 1.000 filas por llamada. Usa page y per (10-5000) para recorrer los resultados, ordena con sort más order=asc|desc. La paginación profunda se detiene en 50.000.
Errores que puedes ver
| Código HTTP | Significado | Qué hacer |
|---|---|---|
| 401 | Falta la clave o es inválida | Comprueba el parámetro key o la cabecera |
| 402 | Se han agotado los créditos | Recarga con USDT (TRC-20) en la página de la cuenta |
Cuando falla una llamada y qué comprobar primero
Dos errores cubren la mayoría de los fallos en la práctica. Cada uno tiene una solución diferente, así que lee el código antes de cambiar cualquier otra cosa.
Una llamada fallida aún te dice algo. Guarda la URL de la solicitud, la hora y el cuerpo de la respuesta en el registro, con la clave eliminada.
Un 401 significa que la clave no es aceptada
Una respuesta 401 indica que falta la clave o es inválida. La solución está en la solicitud, no en los datos. Comprueba el parámetro key o la cabecera Bearer, y asegúrate de que el valor se copió completo. Nunca imprimas la clave mientras depuras.
Digamos que un script funciona en tu portátil y falla en un servidor. Un 401 allí a menudo significa que la variable de entorno nunca se configuró en esa máquina.
Un 402 significa que se ha agotado el saldo
Una respuesta 402 significa que se han gastado los créditos. Nada en los datos está mal, y reintentar la misma llamada fallará de la misma manera hasta que recargues.
Las recargas se realizan en USDT en la red TRC-20 desde la página de la cuenta. Comprueba el saldo antes de una ejecución larga, para que el script no se detenga a mitad de una lista. Establece también un umbral de advertencia, ya que una advertencia temprana es mucho más barata que una auditoría detenida.
Reintentos sin desperdicio
Reintenta solo los errores que pueden cambiar, como un tiempo de espera. Un 401 o 402 reintentado en un bucle añade ruido al registro y no datos a la auditoría.
Pausa entre intentos, y mantén el dominio que falla en una lista separada para que puedas ejecutarlo de nuevo a propósito en lugar de por accidente. Escribe la regla de reintento en un comentario en la parte superior del script, para que la próxima edición la mantenga.
Qué acción para cada pregunta de recuperación
Empareja la pregunta que tienes con la llamada más barata que la responda.
¿Cuál es la magnitud del daño?
Empieza con overview, que es gratuito. Luego ejecuta refdomains una vez y compáralo con el archivo que guardaste el mes pasado. Nuestra rutina mensual muestra la diferencia.
¿Cómo se ven los enlaces basura?
Usa anchors y anchor_cloud. Las palabras extrañas que se repiten en muchos dominios son el patrón a detectar antes de abrir los mitos del disavow.
¿Qué donantes merecen la pena perseguir?
intersect toma de dos a diez dominios y devuelve sitios que enlazan a varios de ellos. Introduce a tus rivales, busca donantes que te omitan, luego puntúa la lista con bulk_dr.
¿Se filtró el cambio?
toppages en el dominio antiguo y en el nuevo muestra dónde llegan los enlaces. El recorrido de migración lo usa paso a paso.
Una auditoría única en cuatro llamadas
Este orden mantiene las llamadas de pago pocas y cada una vinculada a una pregunta. Ejecútalo una vez por dominio, luego repite las llamadas de pago cada mes con la misma configuración.
Ejecuta las llamadas gratuitas
Empieza con overview y domain. Ambas son gratuitas, y su salida establece la escala para cada llamada de pago que sigue.
Obtén los dominios de referencia
Usa refdomains a 2 créditos por llamada. Cuenta primero las páginas, luego decide cuántas necesitarás.
Comprueba la mezcla de anchors
Ejecuta anchors o anchor_cloud a 2 créditos cada una. Busca palabras extrañas que se repitan en muchos dominios.
Puntúa la lista de candidatos
Alimenta los dominios cuestionables a bulk_dr a 1 crédito por llamada, que maneja hasta 2.000 dominios. Mantén las puntuaciones en el mismo archivo que los dominios de referencia.
Una llamada paginada, anotada
Todos los parámetros después de la acción son opcionales.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsUna comparación justa con una alternativa a la API de Moz para backlinks
Las comparaciones justas comienzan con las mismas unidades. Las páginas de precios a menudo ocultan la unidad, así que anota lo que realmente pagas por cada respuesta antes de comparar los totales.
En Ahrefs, las unidades están dentro de una suscripción, que comienza a $129 al mes y compra 200.000 unidades. Cada solicitud utiliza al menos 50 de ellas. Esa es la trampa. Ponlo junto a un precio por llamada, y solo entonces la comparación tiene sentido.
Una prueba similar a similar
Elige cinco dominios de tamaño conocido y ejecuta las mismas preguntas a través de ambos servicios. Compara las respuestas que necesitas, no las características que admiras.
Digamos que un servicio devuelve dominios de referencia en una sola llamada y otro necesita tres. El coste por respuesta entonces importa más que el precio de lista.
Precios en las mismas unidades
Convierte todo a coste por respuesta. Nuestras llamadas se precisan en créditos a $0.0001 cada uno, por lo que una llamada de dos créditos cuesta $0.0002 y una llamada gratuita no cuesta nada. Digamos que una ejecución mensual utiliza siete créditos. Eso son $0.0007, menos de una décima de centavo.
Incluye el coste del desperdicio, como reintentos después de una llamada fallida. Una llamada barata que falla a menudo puede terminar siendo más cara que una más cara que funciona a la primera.
Donde aún gana un paquete completo
La investigación de palabras clave, el seguimiento de posiciones y el rastreo diario están fuera de esta API. Si esas son tus preguntas, un paquete completo las responde mejor, y la comparación debería decirlo.
Usa el libro mayor para la pregunta que responde bien: cómo se movió el perfil de enlaces y qué donantes merecen un examen más cercano. Nombra la brecha en tus notas, como no hay datos de palabras clave aquí, para que el próximo lector no asuma que el libro mayor lo cubre.
