Límites de consumo
La API de Ahrefs está disponible en los planes de pago elegibles. En todos los demás planes, seguirás teniendo acceso a un conjunto limitado de consultas de prueba gratuitas.
Todas las solicitudes, excepto las consultas de prueba gratuitas y los endpoints de Rank Tracker, Management, Public y algunos otros, consumen unidades de API. Si un endpoint es gratuito, verás una nota al respecto en su página de documentación; de lo contrario, consume unidades.
El consumo de unidades por solicitud se calcula de la siguiente manera:
max(base_cost, per_row_cost * num_rows)
El base_cost de cada solicitud es de 50 unidades. El per_row_cost es la suma de los costes de cada campo único que aparece en el resultado devuelto o en los parámetros where u order_by. Si un campo aparece en varios parámetros, se cuenta una sola vez.
El coste predeterminado de un campo es de 1 unidad. Sin embargo, ciertas métricas son más costosas y pueden consumir 5 o 10 unidades. Estas excepciones se indican en la descripción de campos de cada endpoint. Las solicitudes servidas desde la caché no consumen unidades.
Cada solicitud a la API indica su comportamiento de consumo de unidades mediante los siguientes encabezados de respuesta:
x-api-rowsEl número de filas devueltas.x-api-units-cost-rowEl costo en unidades por fila.x-api-units-cost-totalEl total de unidades que la solicitud debería consumir según el número de filas y el costo por fila.x-api-units-cost-total-actualEl total de unidades que la solicitud consumió efectivamente.x-api-cacheSi la solicitud fue atendida desde la caché. Uno de:hitmissno_cache
info
Una buena forma de estimar el costo de una solicitud es ejecutarla con un destino gratuito y comprobar el valor del campo x-api-units-cost-total. Para mostrar los encabezados de la respuesta al usar el comando curl, puede utilizar la opción -v o --verbose.
Ejemplo 1
Considere una solicitud al endpoint Site Explorer - Domain Rating (/site-explorer/domain-rating).
No acepta un parámetro select, where ni order_by, y devuelve una sola fila que contiene dos campos: domain_rating y ahrefs_rank, con un costo por fila de 2 unidades.
El costo total de filas (costo por fila multiplicado por el número de filas) es inferior al costo base. Por lo tanto, esta solicitud cuesta el importe base de 50 unidades.
Ejemplo 2
Considere una solicitud más compleja al endpoint Site Explorer - Backlinks (/site-explorer/all-backlinks), que permite configurar los parámetros select, where y order_by.
Supongamos que esta solicitud tiene dos campos seleccionados:
select=title,traffic
dos campos en la expresión de filtro:
where={"and":[{"field":"traffic","is":["gt",1000]},{"field":"refdomains_source","is":["gt",10]}]}
y un campo de ordenación:
order_by=traffic:desc
En estos parámetros, hay tres campos únicos, de los cuales title y refdomains_source cuestan 1 unidad cada uno, mientras que traffic cuesta 10 unidades. Así, el costo por fila es 1 + 1 + 10 = 12 unidades.
Supongamos que la solicitud devuelve 500 filas. Entonces, el costo total de filas (12 * 500 = 6000 unidades) supera el costo base. Por lo tanto, el costo de esta solicitud es 6000 unidades.