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

Посібник з API

Повний і детальний довідник з API v3 доступний тут: документація Ahrefs API. Ця сторінка — короткий вступ для розробників Ahrefs Connect.

Що можна робити з API v3

Ahrefs API v3 дає змогу отримувати широкий спектр даних, зокрема:

  • Дані про органічний трафік і беклінки із Site Explorer (для вашого сайту або конкурентів)
  • Метрики та ідеї ключових слів із Keywords Explorer
  • Дані SERP Google
  • Дані з проєктів користувача в Rank Tracker і Site Audit
  • І багато іншого — ми регулярно додаємо нові ендпоінти

Одиниці API та вартість запитів

Усі запити — окрім безкоштовних тестових запитів, а також кінцевих точок Rank Tracker, Management, Public і ще кількох інших — списують одиниці API з облікового запису підключеного користувача.

Правила вартості:

  • Залежить від кількості повернених рядків і запитаних полів
  • Мінімальна вартість будь-якого платного запиту: 50 одиниць
  • Якщо кінцева точка безкоштовна, це зазначено на її сторінці документації

Під час розробки

Як пояснено в розділі Як це працює, коли ваш застосунок щойно створено, він матиме статус Неактивний. У цьому режимі ви можете тестувати потоки OAuth і надсилати безкоштовні тестові запити до кінцевих точок API v3 зі свого staging-середовища, не витрачаючи одиниці. Щойно ваш застосунок буде схвалено й активовано, продакшн-запити списуватимуть одиниці за стандартними правилами вартості.

Дізнайтеся більше: Безкоштовні тестові запити і Споживання лімітів API

info

Найкращі практики для економії одиниць API користувача

Надсилаючи запити від імені користувачів, зважайте на їхній щомісячний ліміт.

Ось як мінімізувати споживання одиниць:

  1. Використовуйте select, щоб запитувати лише потрібні поля: більшість ендпоінтів дають змогу вказати поля.
  2. Обмежуйте кількість рядків: використовуйте limit або еквівалентні параметри. Не завантажуйте тисячі рядків без потреби.
  3. За можливості використовуйте bulk-ендпоінти: наприклад, batch-analysis дає змогу отримати метрики для багатьох сторінок за один запит.
  4. Давайте користувачам змогу відстежувати своє використання: ендпоінт limits-and-usage показує, скільки одиниць у них залишилося.