Introducción
Con la API de Ahrefs, puedes utilizar datos de tu espacio de trabajo de Ahrefs para crear integraciones y automatizaciones personalizadas. Actualmente, la API v3 te permite extraer datos de los endpoints de Site Explorer, Keywords Explorer, Vista general SERP, Rank Tracker, Site Audit, Brand Radar y Social Media Management, así como gestionar tus proyectos de Rank Tracker y tus listas de Keywords Explorer:
- Site Explorer: Estadísticas generales y gráficos históricos, Backlinks, informes de tráfico orgánico y de pago
- Keywords Explorer: Métricas para una sola palabra clave o una lista de palabras clave, historial del volumen de búsqueda y volumen por país, informes de ideas de palabras clave
- Site Audit: Health Scores de los proyectos, informes completos de incidencias y contenido de las páginas rastreadas
- Vista general de SERP: Los 100 mejores resultados de la SERP
- Rank Tracker: Vista general del proyecto, informes de la competencia y SERP de Rank Tracker
- Batch Analysis: Métricas de hasta 100 objetivos por solicitud
- Brand Radar: Estadísticas generales de la marca, gráficos históricos de rendimiento y prompts reales con citas en varios agentes de IA
- Gestión de redes sociales: Canales, publicaciones, historial de actividad y métricas de las cuentas de redes sociales conectadas
- Gestión: Endpoints para gestionar tus proyectos de Rank Tracker y tus listas de Keywords Explorer
- Información de la suscripción: Tus límites de API y uso
- Endpoints públicos: Direcciones IP y rangos de IP de nuestro rastreador
Requisitos
La API de Ahrefs está disponible en planes de pago elegibles. En todos los demás planes, seguirás teniendo acceso a un conjunto limitado de consultas de prueba gratuitas.
Límites del plan
Todas las solicitudes, excepto las consultas de prueba gratuitas y los endpoints Rank Tracker, Management, Public y algunos otros, consumen unidades de API. El coste depende del número de filas de una respuesta y de los campos solicitados. El coste mínimo de cualquier solicitud es de 50 unidades. Si un endpoint es gratuito, verás una nota al respecto en su página de documentación; de lo contrario, consume unidades.
Guía relacionada: Consumo de límites
info
Ten en cuenta que las unidades de API, una vez consumidas, no son reembolsables. Recomendamos encarecidamente utilizar nuestras consultas de prueba gratuitas para todo el desarrollo y las pruebas, a fin de mitigar cualquier consumo involuntario de unidades de API.
También recomendamos establecer límites en tus claves de API, especialmente cuando estás en la fase de pruebas y desarrollo.
Los planes de pago elegibles incluyen una asignación mensual de unidades de API. En los planes que admiten el uso por consumo, las unidades adicionales se cobran automáticamente una vez que se supera el límite incluido.
Si tienes una suscripción anual, puedes ahorrar pagando por adelantado unidades de API adicionales con un descuento. Puedes hacer seguimiento del consumo de unidades de API y comprar complementos prepagados en Configuración de la cuenta / Límites y uso.
Consulta también: Página de precios
Claves API
Para enviar solicitudes a la API de Ahrefs, necesitarás una clave de API. Solo los propietarios del espacio de trabajo y los administradores pueden crear y gestionar claves de API. Esto se puede hacer en Configuración de la cuenta / Claves de API.
Guía relacionada: Creación y gestión de claves de API
Uso básico
Comienza rápidamente con estos botones de API en los informes de Ahrefs. Haz clic en ellos para mostrar la solicitud como un comando cURL.
Estos botones se pueden usar como un generador de consultas, ya que el comando cURL se actualizará dinámicamente con cualquier filtro que apliques al informe.
Ten en cuenta que cURL contiene todos los campos y métricas que se muestran en el informe actual. Puedes eliminar los campos que no necesites para reducir el coste de una solicitud.
Para ver todos los detalles de uso, consulta nuestra referencia de la API en esta documentación. La referencia incluye una especificación compatible con OpenAPI del formato de solicitud y respuesta de cada endpoint.
Limitación de tasa
De forma predeterminada, la API de Ahrefs está limitada a 60 solicitudes por minuto. Si se supera este límite, la API responderá con un código de estado HTTP 429 (Too Many Requests).
Además, para mantener un rendimiento óptimo y la estabilidad del sistema, las solicitudes a la API pueden rechazarse ocasionalmente con el mismo código de estado HTTP 429 debido a la limitación de velocidad. La limitación de velocidad se produce de forma dinámica en función de la carga del sistema en tiempo real, la disponibilidad de recursos y las exigencias computacionales de tus solicitudes.