Подключение Ahrefs: API v3 ключ, типы данных и лимит юнитов
Подключите собственный ключ Ahrefs API v3 в качестве источника данных; узнайте, какие типы данных он обслуживает, сколько юнитов расходует каждое действие и как установить ежемесячный лимит.
Открыть этот экран в панелиЕсли у вас есть подписка Ahrefs, SEOAsist может использовать её данные в качестве источника данных. SEOAsist отслеживает позиции, находит пробелы в контенте (content gap), применяет исправления и формирует отчёты на основе этих данных. Подключение является необязательным и работает на основе вашего собственного ключа API v3: каждый запрос расходует юниты API из вашей учётной записи Ahrefs.
Само по себе подключение ничего не меняет. В таблице "Источники данных" на вкладке "Данные" в Настройки → Интеграции вы выбираете, на какие типы данных отвечает Ahrefs. Платный источник никогда не используется, пока вы его не выберете.
Какие типы данных он обслуживает?
| Тип данных | Эндпоинт Ahrefs API v3 | Качество |
|---|---|---|
| Отслеживание позиций | Site Explorer → organic-keywords (лучшая позиция и URL) | Приблизительное: позиции из базы данных Ahrefs, а не проверка SERP в реальном времени |
| Частотность / CPC / KD | Keywords Explorer → overview | Полное |
| Идеи ключевых слов | Keywords Explorer → related-terms, matching-terms для низкочастотных запросов | Полное |
| Конкуренты и пробелы в контенте | Site Explorer → organic-competitors, список organic-keywords обоих доменов | Полное |
| Обратные ссылки | Site Explorer → backlinks-stats, domain-rating, all-backlinks (одна ссылка на домен, включая ссылки, утраченные за последние 90 дней), refdomains | Полное (спам-флаг Ahrefs отображается как токсичный) |
Локальная карта (local map grid) не работает с Ahrefs; для неё требуется DataForSEO. Domain Rating (0–100) отображается в колонке "позиция" в разделах обратных ссылок.
Предварительные требования
- Учётная запись Ahrefs с доступом к API v3 (тарифный план Enterprise или дополнение API add-on).
- Роль "admin" в SEOAsist.
Получение ключа API
- Войдите в app.ahrefs.com.
- Перейдите в Account settings → API keys (создавать ключи могут только владельцы рабочей области и администраторы).
- Создайте ключ и скопируйте его.
Подключение к SEOAsist
- Откройте карточку "Ahrefs" на вкладке "Данные" в Настройки → Интеграции.
- Вставьте ключ и нажмите "Подключить".
- Перед сохранением SEOAsist вызывает бесплатный эндпоинт Ahrefs
limits-and-usage. При успехе вы увидите «Ahrefs подключен. Осталось юнитов: …». - В таблице "Источники данных" на той же вкладке выберите "Ahrefs (ваша учётная запись)" для нужных типов данных.
Ключ хранится в зашифрованном виде и никогда не передаётся в браузер в открытом тексте. Функция "Проверить соединение" показывает оставшиеся юниты и не расходует их.
Сколько юнитов расходует каждое действие?
Ahrefs списывает минимум 50 юнитов за платный запрос; стоимость строки равна сумме выбранных полей (большинство полей — 1 юнит, частотность / KD / интент / трафик — 10 юнитов). Значения ниже являются верхней оценкой.
| Действие | Эндпоинт | Максимум |
|---|---|---|
| Подбор ключевых слов ("Идеи" / "Низкочастотные") | related-terms / matching-terms, 32 за строку | 100 строк → 3 200 |
| Заполнение частотности / CPC / KD | overview, 32 за ключевое слово | 300 ключевых слов → 9 600 |
| Проверка позиций | organic-keywords, 3 за строку | 1 снятие в день, 1 000 строк → 3 000 |
| Поиск конкурентов | organic-competitors, 13 за строку | 15 строк → 195 |
| Синхронизация конкурентов | organic-keywords, 27 за строку | 500 на конкурента + 1 000 ваших собственных |
| Синхронизация бэклинков | backlinks-stats 50 + domain-rating 50 + all-backlinks 10 за строку | 500 ссылок → 5 100 |
| Возможности для бэклинков | refdomains, 5 за строку | 300 строк на конкурента, до 5 конкурентов |
Синхронизация конкурентов — самое дорогое действие при работе с Ahrefs. Попробуйте сначала на одном конкуренте и установите ежемесячный лимит.
Ежемесячный лимит юнитов
Введите число в поле "Ежемесячный лимит юнитов" на карточке Ahrefs и нажмите "Сохранить". Перед каждым вызовом SEOAsist суммирует ориентировочное использование за этот месяц и предполагаемую стоимость вызова; если лимит будет превышен, вызов не отправляется, и вы получаете уведомление. Оставьте поле пустым, чтобы снять лимит. Точный расход можно посмотреть на app.ahrefs.com → API keys.
Ошибки
| Сообщение | Значение | Что делать |
|---|---|---|
| API key was rejected | HTTP 401: неверный, истекший или удаленный ключ | Создайте новый ключ и подключите заново |
| API units ran out | Достигнут лимит юнитов | Добавьте юниты в Ahrefs или дождитесь даты сброса |
| No API access | HTTP 403: тарифный план не покрывает этот эндпоинт | Проверьте ваш тарифный план Ahrefs |
| Rate limit exceeded | HTTP 429 (по умолчанию 60 запросов в минуту) | SEOAsist ждёт и делает повторную попытку |
| Monthly unit cap reached | Установленный вами лимит | Увеличьте лимит или дождитесь нового месяца |
При ошибке ключа, юнитов или доступа на соответствующих страницах отображается баннер «Ahrefs не работает», а владелец получает уведомление раз в день. Выбранный источник, в котором произошел сбой, никогда незаметно не заменяется бесплатным.
FAQ
Почему позиции указаны как «Приблизительные»?
Позиции берутся из базы данных Ahrefs; Ahrefs обновляет их по собственному расписанию и только для известных ему ключевых слов. Для ежедневной проверки SERP в реальном времени выберите DataForSEO для позиций.
Как удалить подключение?
Откройте карточку, нажмите "Удалить" и подтвердите. Типы данных, настроенные на Ahrefs, перейдут на бесплатный уровень; выберите другой источник в таблице "Источники данных", если необходимо. История Ahrefs сохраняется, но не пополняется.
Берет ли SEOAsist плату за Ahrefs?
Нет. Юниты списываются напрямую из вашей учётной записи Ahrefs. См. Расходы.
Похожие статьи
- Источники данных: бесплатный уровень, Bing Webmaster, платформенные данные и DataForSEOОткуда берутся позиции, объем поиска, идеи ключевых слов, темы конкурентов и обратные ссылки, что могут и чего не могут бесплатные источники и входящие в тариф платформенные данные, как добавить ключ Bing Webmaster и как выбрать источник для каждого типа данных.
- Подключение Semrush: API-ключ, типы данных и лимит юнитовПодключите свой API-ключ Semrush в качестве источника данных, узнайте доступные типы данных, расход юнитов API и настройку ежемесячного лимита.
- DataForSEO: данные платформы, собственный аккаунт, расходы и балансИспользуйте данные DataForSEO через данные платформы SEOAsist, включенные в тариф, или свой аккаунт; узнайте о поддерживаемых модулях, лимитах и расходе баланса.
- Расходы: лимиты ИИ, собственные ключи и DataForSEOЧастые вопросы о том, что входит в ваш тариф, за что вы платите через собственные аккаунты и как рассчитываются ежемесячные квоты.
- Обратные ссылки: вкладки, функция «Синхронизировать» и еженедельное обновлениеУзнайте, что отображается на каждой вкладке страницы «Обратные ссылки», как работает фоновая синхронизация и какие уведомления вы получите при ошибке.