Referencia
Informe de backlinks de Ahrefs frente a la salida de la API: una referencia de acciones
Si estás acostumbrado a exportar un informe de backlinks de Ahrefs, esta referencia muestra qué partes puedes reconstruir con nuestras acciones, cuánto cuesta cada llamada y dónde las suites grandes se mantienen por delante.
Acciones, precios y lo que reemplazan en un informe
| Acción | Créditos | Parte más cercana de un informe típico | Notas |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | Conteo de encabezados | No se necesita clave |
| bulk_dr | 1 | Una columna DR para una lista | Hasta 2.000 dominios por llamada |
| compare | 1 | Dominios lado a lado | Hasta 20 dominios |
| top, dr_distribution, tld_breakdown | 1 | Gráficos de resumen | Resumen estilo distribución |
| refdomains | 2 | Pestaña de dominios de referencia | Paginado |
| backlinks | 2 | Pestaña de backlinks | Paginado |
| anchors, anchor_cloud | 2 | Pestaña de anclas | La nube es para visualización |
| toppages | 2 | Mejores por enlaces | Páginas que atraen enlaces |
| intersect | 2 | Intersección de enlaces | De 2 a 10 dominios |
| search, keyword | 3 | Sin coincidencia directa | Búsqueda de ancla, título y URL |
Cómo se mapean las pestañas del informe en nuestras acciones
La mayoría de las exportaciones de informes vienen en pestañas, y cada pestaña tiene un equivalente aproximado aquí. No es una copia exacta. Lee el mapeo como punto de partida, ya que un campo que existe en una pestaña puede no existir en nuestra respuesta en absoluto.
La pestaña de dominios de referencia
Imagina un informe que se abre en dominios de referencia ordenados por DR. Nuestra opción más cercana es refdomains, a 2 créditos, y se puede ordenar de la misma manera. Espera tener que renombrar una o dos columnas en tu script, ya que los nombres de los campos de la fila varían según la acción.
Corrige el orden entre meses. Una lista ordenada por DR un mes y por tráfico al siguiente no se puede comparar honestamente, así que escribe la clave de orden en el nombre del archivo.
La pestaña de anclas y por qué la nube es para visualización
anchors es la llamada para la pestaña de anclas, a 2 créditos. anchor_cloud cuesta lo mismo, pero como dice la tabla anterior, está destinada a la visualización. Si una decisión depende de números, lee la lista simple.
Lee las anclas con una pregunta: ¿un redactor real escribiría estas palabras? Los nombres de marca y las URL desnudas suelen pasar. Un bloque de frases monetarias idénticas repetidas en muchos dominios no, y ese bloque es la parte que debes verificar primero.
Páginas principales y la vista de dos a diez dominios
toppages es lo más cercano a una pestaña de mejores por enlaces. Muestra qué páginas atraen enlaces, y eso a menudo dice más que un total de dominio cuando un movimiento de ranking afecta una carpeta del sitio.
intersect toma entre dos y diez dominios y cuesta 2 créditos por llamada. Digamos que comparas tu sitio con dos rivales. La superposición muestra entonces qué sitios enlazadores comparten los tres, lo cual es simple y económico.
Parámetros que se aplican en todas las llamadas
Tres cosas controlan cada lista. Son page, per y el par sort con order. Mantenlos fijos entre meses.
per acepta de 10 a 5000, aunque una llamada devuelve hasta 1.000 filas, y la paginación profunda se detiene en 50.000 filas. Cada llamada se cobra una vez sin importar el recuento de filas, así que pedir una página completa cuesta lo mismo que pedir diez filas.
La autenticación requiere ya sea key=sk_... en la consulta o un encabezado Authorization: Bearer sk_.... CORS es abierto, pero mantén la clave en tu servidor de todos modos, ya que el código del navegador la expone a todos los visitantes.
El orden importa. Cuando paginas a través de los resultados, ordena por DR descendente para los dominios que probablemente importan, o ascendente para inspeccionar la cola larga de sitios pequeños. Cualquiera que sea tu elección, anótala junto al archivo.
Trata la tabla anterior como un mapa y las respuestas guardadas como el territorio. Si falta un campo que esperabas, construye alrededor de lo que hay.
Una exportación mensual, en cinco pasos
Ejecuta los mismos cinco pasos cada mes, para que los archivos guardados se alineen cuando los compares.
- 1
Elige las llamadas
Elige
refdomains,anchorsytoppagespara cada dominio. Overview y stats son gratuitos, así que añádelos a la misma carpeta. - 2
Fija la profundidad
Establece
page,per,sortyorderuna vez y mantenlos. Per puede llegar hasta 5000, pero una sola llamada devuelve hasta 1.000 filas. - 3
Guarda cada respuesta sin cambios
Escribe el JSON crudo en el disco antes de cualquier análisis. Si un script falla más tarde, la copia guardada es lo que volverás a ejecutar.
- 4
Lee el objeto _credits
Cada respuesta autenticada informa su costo y el saldo restante. Copia ambos en una línea de registro, para que el gasto del mes sea visible sin un panel de control.
- 5
Compara con el mes pasado
Diferencia las copias guardadas. La receta de diff enumera las tres columnas que vale la pena mantener.
Créditos, límites de filas y una factura mensual
La lista de precios es corta. La factura depende de la frecuencia de llamadas y de cómo paginas. Tres hábitos deciden la mayor parte.
Un cargo por llamada, sin importar las filas
Cada llamada se cobra una vez, así que per=1000 cuesta lo mismo que per=10 para la misma acción. Una página completa es la opción barata para una lista que reutilizarás, y la derrochadora para una consulta rápida.
Digamos que extraes refdomains para un dominio el mismo día cada mes. Eso son 2 créditos, o $0.0002, al mes a la tarifa publicada de $0.0001 por crédito.
El techo de 50.000 filas
La paginación profunda se detiene en 50.000 filas. Un bucle que sigue pidiendo la siguiente página después de eso no obtiene nada nuevo, así que limita el recuento de páginas antes de que comience el bucle.
Alcanzar el techo a 1.000 filas por llamada requiere cincuenta llamadas. A 2 créditos cada una, eso son 100 créditos, o $0.01. Barato, pero solo si el script se detiene cuando debe.
Un pequeño presupuesto para un hábito mensual
Imagina diez dominios, cada uno con refdomains y anchors extraídos una vez al mes. Eso son 40 créditos al mes, o $0.004, extraídos de los $100 de crédito gratuito al registrarse, que equivalen a 1.000.000 de créditos.
A ese ritmo, el crédito gratuito dura mucho tiempo, y el registro de gastos muestra si el ritmo se mantiene. Mantenlo.
Solución de problemas de respuestas
| Ves | Causa | Solución |
|---|---|---|
| HTTP 401 | Clave faltante o incorrecta | Verifica la clave y la ortografía del encabezado |
| HTTP 402 | Se han agotado los créditos | Recarga en USDT (TRC-20) en la página de la cuenta |
| ok es false | La solicitud fue rechazada | Lee el mensaje en el cuerpo y los parámetros que enviaste |
| Menos filas de lo que muestra una suite grande | Índice y tiempo de rastreo diferentes | Compara tendencias, no totales |
| Falta un enlace que hiciste la semana pasada | Índice reconstruido aproximadamente cada mes | Vuelve a verificar en el siguiente ciclo |
Una fila faltante es una pregunta, no una respuesta
Una fila que desaparece entre dos respuestas es una sorpresa común. Antes de decidir qué significa, separa las historias que podría contar.
Tres historias detrás de una fila faltante
El enlace puede no haberse indexado nunca, o puede haber sido eliminado. La tercera historia es el tiempo: la página fue rastreada antes o después de una reconstrucción del índice, y la fila aparece en un ciclo posterior.
Una llamada no puede separar estas historias. Solo una segunda copia tomada más tarde, más un vistazo a la página en sí, reduce la lista.
Pesa la fila antes de perseguirla
Verifica el DR del dominio y la página enlazadora antes de cualquier outreach. Un enlace eliminado de un sitio débil rara vez cambia un plan. Un enlace eliminado de una página que atrajo lectores puede merecer una nota a su propietario. La tabla de sospechosos muestra dónde se sitúa una fila faltante entre las causas más amplias.
Mover una exportación a nuestras llamadas
¿Puedo exportar las mismas columnas que da Ahrefs?
No uno por uno. Los campos de la fila varían según la acción, así que abre una respuesta guardada y mapea los nombres tú mismo. La tabla anterior nombra la acción más cercana para cada parte de un informe, pero los nombres de los campos diferirán.
¿Es la API más barata que una suscripción de Ahrefs?
La respuesta depende del volumen de llamadas. Nuestro precio publicado es $0.10 por 1.000 llamadas de un crédito. Ahrefs vende unidades de API dentro de suscripciones, desde $129 al mes por 200.000 unidades, con al menos 50 unidades por solicitud. Cuenta tus llamadas antes de decidir.
¿Las exportaciones antiguas seguirán comparándose con las nuevas?
Solo si el orden, la profundidad y la fuente coinciden. Un archivo extraído de una herramienta diferente en una semana diferente es una muestra diferente. Guarda los archivos antiguos y comienza la nueva serie con un par claramente etiquetado.
¿Necesito mantener la clave en mi servidor?
Sí. CORS es abierto, así que un navegador puede llamar a la API, pero una clave en el código front-end es visible para todos los visitantes. Envía solicitudes desde tu servidor y lee la clave desde una variable de entorno.
Antes de construir un informe sobre estas llamadas
- Abre una respuesta guardada por acción y anota los nombres de los campos de fila que realmente recibes.
- Decide qué etiqueta de mes va en cada nombre de archivo.
- Mantén
page,per,sortyorderidénticos entre extracciones mensuales. - Registra el objeto
_creditsde cada respuesta autenticada para que el gasto por trabajo sea visible. - Limita la paginación profunda en tu script, ya que las listas se detienen en 50.000 filas.
- Añade una nota de frescura a cualquier informe que entregues, indicando que el índice se actualiza aproximadamente cada mes.
Leyendo el sobre
Cada respuesta lleva ok. Las autenticadas también añaden _credits, para que puedas registrar el gasto por trabajo y vigilar el saldo.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"Ahrefs vende unidades de API dentro de suscripciones, desde $129 al mes por 200.000 unidades con un mínimo de 50 unidades por solicitud. También ofrece palabras clave, seguimiento de ranking y un rastreo más fresco, al igual que Semrush. Cubrimos datos de enlaces a un precio bajo por llamada y nada más. Usa el manual mensual si esa es la brecha que necesitas llenar. El árbol de decisiones de picos de spam es un buen primer uso de las llamadas de resumen económicas.
