Docs
Buscar documentación...⌘K

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:

  1. Usa select para solicitar solo los campos necesarios: la mayoría de los endpoints te permiten especificar los campos.
  2. Limita el número de filas: usa limit o parámetros equivalentes. Evita extraer miles de filas salvo que sea necesario.
  3. Usa endpoints masivos cuando sea posible: por ejemplo, batch-analysis te permite obtener métricas de muchas páginas en una sola solicitud.
  4. Permite que los usuarios controlen su uso: el endpoint limits-and-usage muestra cuántas unidades les quedan.