Посібник з 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 користувача
Надсилаючи запити від імені користувачів, зважайте на їхній щомісячний ліміт.
Ось як мінімізувати споживання одиниць:
- Використовуйте
select, щоб запитувати лише потрібні поля: більшість ендпоінтів дають змогу вказати поля. - Обмежуйте кількість рядків: використовуйте
limitабо еквівалентні параметри. Не завантажуйте тисячі рядків без потреби. - За можливості використовуйте bulk-ендпоінти: наприклад,
batch-analysisдає змогу отримати метрики для багатьох сторінок за один запит. - Давайте користувачам змогу відстежувати своє використання: ендпоінт
limits-and-usageпоказує, скільки одиниць у них залишилося.