Docs
Пошук документації...⌘K

Вступ

З Ahrefs API ви можете використовувати дані зі свого робочого простору Ahrefs для створення власних інтеграцій та автоматизацій. Наразі API v3 дає змогу отримувати дані з ендпойнтів Site Explorer, Keywords Explorer, Огляд SERP, Rank Tracker, Site Audit, Brand Radar і Social Media Management, а також керувати вашими проєктами Rank Tracker та списками Keywords Explorer:

  • Site Explorer: оглядова статистика та історичні графіки, беклінки, звіти про органічний і платний трафік
  • Keywords Explorer: метрики для одного ключового слова або списку ключових слів, історія обсягу пошуку та обсяг пошуку за країнами, звіти з ідеями ключових слів
  • Site Audit: показники здоров’я проєктів, повні звіти щодо проблем і вміст просканованих сторінок
  • Огляд SERP: топ-100 результатів SERP
  • Rank Tracker: огляд проєкту, звіти про конкурентів і SERP-и Rank Tracker
  • Batch Analysis: метрики для до 100 цілей за запит
  • Brand Radar: оглядова статистика бренду, історичні графіки ефективності та реальні запити з цитуваннями для кількох агентів ШІ
  • Управління соціальними мережами: канали, дописи, історія активності та метрики для підключених облікових записів соцмереж
  • Управління: ендпойнти для керування вашими проєктами Rank Tracker і списками Keywords Explorer
  • Інформація про підписку: ваші ліміти API та використання
  • Публічні ендпойнти: IP-адреси та діапазони нашого сканера

Умови доступу

Ahrefs API доступний на платних тарифах, що відповідають вимогам. На всіх інших тарифах ви все одно матимете доступ до обмеженого набору безплатних тестових запитів.

Ліміти тарифу

Усі запити, окрім безплатних тестових запитів і кінцевих точок Rank Tracker, Management, Public та some other, споживають одиниці API. Вартість залежить від кількості рядків у відповіді та запитаних полів. Мінімальна вартість будь-якого запиту — 50 одиниць. Якщо кінцева точка безплатна, ви побачите про це примітку на її сторінці документації; інакше вона споживає одиниці.

Пов’язаний посібник: Споживання лімітів

info

Зверніть увагу, що використані одиниці API не підлягають поверненню. Ми наполегливо радимо використовувати наші безплатні тестові запити для всіх цілей розробки та тестування, щоб знизити ризик ненавмисного використання одиниць API.

Також рекомендуємо встановлювати ліміти на ваші ключі API, особливо на етапі тестування та розробки.

Платні плани, що відповідають вимогам, включають щомісячну квоту одиниць API. У планах із підтримкою оплати за фактом використання додаткові одиниці автоматично списуються після перевищення включеного ліміту.

Якщо у вас річна підписка, ви можете заощадити, передоплативши за більшу кількість одиниць API зі знижкою. Ви можете відстежувати споживання одиниць API та купувати доповнення з передоплатою в Налаштуваннях облікового запису / Ліміти та використання.

Див. також: Сторінка цін

Ліміти та використання

Ключі API

Щоб надсилати запити до Ahrefs API, вам знадобиться ключ API. Лише власники робочого простору та адміністратори можуть створювати й керувати ключами API. Це можна зробити в Налаштуваннях облікового запису / Ключі API.

Пов’язаний посібник: Створення та керування ключами API

Основи використання

Швидко почніть роботу з цими кнопками API у Звітах Ahrefs. Натисніть їх, щоб відобразити запит як команду cURL.

Кнопка API

Ці кнопки можна використовувати як конструктор запитів, адже команда cURL динамічно оновлюватиметься з урахуванням будь-яких фільтрів, які ви застосуєте до звіту.

Зверніть увагу: cURL містить усі поля та метрики, показані в поточному звіті. Ви можете прибрати поля, які вам не потрібні, щоб зменшити вартість запиту.

Щоб дізнатися всі подробиці щодо використання, перегляньте наш довідник API в цій документації. Довідник містить сумісну з OpenAPI специфікацію формату запиту й відповіді кожної кінцевої точки.

Обмеження частоти запитів

За замовчуванням Ahrefs API обмежено 60 запитами на хвилину. Якщо цей ліміт перевищено, API відповість кодом стану HTTP 429 (Too Many Requests).

Крім того, для підтримки оптимальної продуктивності та стабільності системи запити до API інколи можуть відхилятися з тим самим кодом стану HTTP 429 через обмеження інтенсивності. Обмеження інтенсивності застосовується динамічно залежно від навантаження на систему в реальному часі, доступності ресурсів і обчислювальних потреб ваших запитів.

Посилання