Guía de la API
Aquí tienes una referencia completa y detallada de la API v3: Documentación de la API de Ahrefs. Esta página es una breve introducción para desarrolladores de Ahrefs Connect.
Qué puedes hacer con la API v3
La API v3 de Ahrefs te permite extraer una amplia variedad de datos, entre ellos:
- Datos orgánicos y de Backlinks de Site Explorer (para tu sitio o el de tus competidores)
- Métricas e ideas de palabras clave de Keywords Explorer
- Datos de las SERP de Google
- Datos de los Proyectos de Rank Tracker y Site Audit del usuario
- Y mucho más: añadimos nuevos endpoints con regularidad
Unidades de la API y costes de las solicitudes
Todas las solicitudes — excepto las consultas de prueba gratuitas y algunos puntos finales como Rank Tracker, Management, Public y otros — consumen unidades de la API de la cuenta del usuario conectado.
Reglas de coste:
- Depende del número de filas devueltas y de los campos solicitados
- Coste mínimo de cualquier solicitud de pago: 50 unidades
- Si un punto final es gratuito, se indica como tal en su página de documentación
Durante el desarrollo
Tal y como se explica en Cómo funciona, cuando tu aplicación se crea por primera vez, estará en estado Inactivo. En este modo, puedes probar los flujos de OAuth y enviar solicitudes de prueba gratuitas a los endpoints de la API v3 desde tu entorno de staging sin consumir unidades. Una vez que tu aplicación se apruebe y se active, las solicitudes en producción consumirán unidades según las reglas de coste habituales.
Más información: Consultas de prueba gratuitas y Consumo de los límites de la API
info
Buenas prácticas para ahorrar unidades de la API del usuario
Al hacer solicitudes en nombre de los usuarios, ten en cuenta su asignación mensual.
A continuación te explicamos cómo minimizar el consumo de unidades:
- Usa
selectpara solicitar solo los campos necesarios: la mayoría de los endpoints te permiten especificar los campos. - Limita el número de filas: usa
limito parámetros equivalentes. Evita extraer miles de filas salvo que sea necesario. - Usa endpoints masivos cuando sea posible: por ejemplo,
batch-analysiste permite obtener métricas de muchas páginas en una sola solicitud. - Permite que los usuarios controlen su uso: el endpoint
limits-and-usagemuestra cuántas unidades les quedan.