Документация
Справочник по эндпоинтам и тарифам
Один URL, множество действий. Это полный набор возможностей.
Исследовательская команда SEOCheck ·

Действия и стоимость
| Действие | Кредиты | Что возвращает |
|---|---|---|
| domain | бесплатно | Базовая запись и DR для одного домена |
| overview | бесплатно | Сводка по ссылочному профилю домена |
| stats | бесплатно | Статистика по всему индексу |
| suggest | бесплатно | Подсказки доменов при вводе |
| bulk_dr | 1 | DR для до 2 000 доменов |
| compare | 1 | Сравнение до 20 доменов |
| top | 1 | Топовые домены |
| dr_distribution | 1 | Распределение DR среди ссылающихся доменов |
| tld_breakdown | 1 | Ссылки по доменам верхнего уровня |
| refdomains | 2 | Ссылающиеся домены |
| backlinks | 2 | Отдельные обратные ссылки |
| anchors | 2 | Якорные тексты |
| toppages | 2 | Самые ссылочные страницы |
| anchor_cloud | 2 | Веса якорей |
| intersect | 2 | Общие линкеры для 2–10 доменов |
| search | 3 | Полнотекстовый поиск по якорям, заголовкам и URL |
| keyword | 3 | Кто ссылается с точным якорем |
Аутентификация и формат
Базовый URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Предпочитаете заголовки? Отправляйте Authorization: Bearer sk_... вместо этого.
Этот API анализа обратных ссылок отвечает в формате JSON и поддерживает кросс-доменные запросы, поэтому браузер может обращаться к нему напрямую. Каждый ответ содержит поле ok. Аутентифицированные ответы также содержат _credits, который указывает стоимость запроса и ваш оставшийся баланс.
Ошибки сообщаются прямолинейно. HTTP 401 означает, что ключ отсутствует или неверен. HTTP 402 означает, что баланс исчерпан. Обе ошибки легко обрабатываются, и ни одну из них не следует повторять в цикле.
Перед первым платным запросом
- Запустите
overviewдля домена, который вам известен. Это бесплатно. - Проверьте работоспособность ключа с помощью одного запроса за 1 кредит, например
compare. - Прочитайте
_creditsв ответе и убедитесь, что стоимость соответствует таблице выше. - Настройте срабатывание скрипта при получении HTTP 402, чтобы исчерпание баланса не приводило к тихим сбоям.
Пагинация и сортировка
Количество строк в одном запросе может достигать 1 000. Укажите нужное количество с помощью параметра per (от 10 до 5000), переходите по страницам с помощью page и сортируйте результаты с помощью sort и order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Параметры, влияющие на ответ
Каждое действие принимает два базовых параметра: action и q, а также набор дополнительных опций. Изучите их перед использованием. Большинство ошибок возникает из-за опций, которые кажутся необязательными, но влияют на стоимость или структуру строк. Изучите опции, прежде чем копировать запрос из форума или блога.
В примерах ниже предполагается использование ключа в параметре key. Замените заполнитель на свой. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Все примеры в этом справочнике по API анализа обратных ссылок используют один базовый URL.
Пагинация с помощью page и per
Параметр per задает количество возвращаемых строк: от 10 до 5000. Параметр page позволяет перемещаться по набору данных. Запрос, запрашивающий 500 строк, а затем page 2, возвращает следующую порцию данных, а не повторный запрос тех же строк.
Глубокая пагинация ограничена 50 000 строками. Если задача требует большего объема, сузьте запрос с помощью sort или разделите работу по доменам, чтобы каждый запрос оставался в пределах лимита.
Сортировка с помощью sort и order
Сортируйте на сервере, а не в скрипте. Запрос sort=dr&order=desc возвращает домены с самым высоким DR в первую очередь, так что самые важные строки попадают на первую страницу. Фильтрация после полной загрузки тратит время и кредиты.
Используйте order=asc, если вам нужны наименее сильные строки, например, чтобы найти слабые ссылки или обнаружить резкое падение ссылочного профиля.
Списки: bulk_dr, compare и intersect
Действия со списками принимают несколько доменов в одном запросе. bulk_dr принимает до 2 000 доменов за 1 кредит с помощью GET-запроса или POST-тела. compare принимает до 20 доменов, а intersect — от двух до десяти.
Поскольку цена не зависит от количества строк, длинный список в одном запросе дешевле, чем множество коротких запросов. Например, проверка 1 500 сайтов-кандидатов в понедельник — это один запрос, а не 1 500.
Запросы search и keyword стоят дороже
Действие search выполняет полнотекстовый поиск по якорям, заголовкам и URL. Действие keyword показывает, кто ссылается с точным якорем. Оба запроса стоят три кредита, поэтому используйте их для ответа на конкретный вопрос, а не для навигации.
Выбор per и page для первого запроса
Для первичного ознакомления с новым доменом начните с небольшого значения per, например 50. Вы увидите структуру строк, имена полей и стоимость в одном коротком ответе. Увеличивайте per только тогда, когда убедитесь, что строки соответствуют вашим требованиям. Этот же подход применим ко всем действиям в таблице выше.
Распространенная ошибка — запросить 5000 строк с первого раза, а затем отбросить большую их часть. Ответ становится больше, ожидание дольше, а ожидаемая экономия не проявляется.
Чтение счетчика кредитов
Каждый аутентифицированный ответ завершается блоком _credits, который указывает стоимость запроса и баланс после него. Логируйте эти данные. Если суммировать их в конце месяца, вы будете знать точную сумму счета.
Примерный бюджет помогает. Тысяча запросов refdomains стоит 2 000 кредитов, что составляет $0.20. Тысяча запросов search стоит 3 000 кредитов, или $0.30. Ежедневный запуск bulk_dr для списка из 2 000 доменов стоит 1 кредит, то есть около $0.003 в месяц.
В сравнении с планами, начинающимися с $129 в месяц за 200 000 API-единиц, как указывает Ahrefs, структура счета отличается. См. сравнение, чтобы узнать подробности.

Чтение ошибок и поля _credits
Ответ может завершиться ошибкой двумя разными способами, и ваш код должен обрабатывать их по-разному. Это разные проблемы. Неверный ключ — это проблема конфигурации. Пустой баланс — это проблема биллинга. Обработка обоих случаев как одной общей ошибки скрывает, какое именно исправление требуется.
Сначала прочитайте поле ok. Затем прочитайте блок _credits. И только после этого обращайте внимание на строки, так как отсутствие или неполнота результата легче объяснить, если вы уже знаете стоимость запроса.
Обработка 401 и 402 раздельно
HTTP 401 означает, что ключ отсутствует или неверен. Остановите задачу и исправьте ключ. HTTP 402 означает, что баланс исчерпан. Пополните его на странице аккаунта и продолжайте работу. Повторный запрос при 401 не поможет, как и повторный запрос при 402 без пополнения баланса.
Логируйте баланс до и после запуска
Записывайте баланс _credits в начале и в конце запуска. Разница должна соответствовать ожидаемой стоимости выполненных запросов. Более значительное изменение означает, что цикл выполнился чаще, чем планировалось.
Для быстрой проверки умножьте количество запросов на их стоимость в кредитах. Если ответ 40, а баланс упал на 4 000, значит, в скрипте есть ошибка, а не в прайс-листе.
Проверка возвращаемых строк
Успешный ответ с меньшим количеством строк, чем ожидалось, не является автоматической ошибкой. У небольшого домена может просто быть мало ссылок. Сравните количество строк со значением per, которое вы отправили, и рассматривайте разницу как вопрос для анализа, а не как скрытый дефект.
Сначала тестируйте дешевые запросы
Перед тем как включить запрос в задачу, выполните его вручную с минимально возможными параметрами. Проверьте ответ, имена полей и значение _credits. Задачу, которая ломается на второй строке, гораздо сложнее отладить, чем запрос, который выдал ошибку с первого раза.
Первая сессия с API
Четыре запроса по порядку, чтобы каждый последующий запрос был вам уже понятен. Только первый запрос бесплатный, и это намеренно.
Запустите overview для известного домена
Это бесплатно и не требует ключа. Сравните сводку с тем, что вы видите в Search Console и на самом сайте, чтобы понимать, как выглядит нормальный ответ.
Проверьте ключ с помощью одного запроса за 1 кредит
Отправьте compare с вашим доменом и одним конкурентом. Убедитесь, что поле ok равно true, а _credits указывает стоимость в один кредит.
Получите список за 2 кредита с небольшим значением per
Запросите refdomains с per=50 и sort=dr. Проверьте, что количество строк и стоимость в кредитах соответствуют таблице выше.
Запишите стоимость в лог
Запишите баланс до и после. С этого момента каждый ваш скрипт будет начинаться с этой привычки, и неожиданный счет станет просто строкой в логе, а не загадкой.
Тарифы
Предоплаченные кредиты. Один кредит равен $0.0001. Подписки и ежемесячного минимума нет.
Бесплатные действия
$0
- domain, overview, stats, suggest
- Ключ не требуется
- Обеспечивает работу веб-чекера
Оплата по факту использования
$0.10за 1 000 запросов за 1 кредит
- $100 бесплатных кредитов при регистрации
- Карта не требуется
- Пополнение через USDT (TRC-20)
- Биллинг за один запрос, а не за строку
Лимиты, которые нужно знать
Индекс охватывает 181 132 097 доменов и 2 774 625 913 ссылок между доменами. Обновление происходит примерно раз в месяц. Это медленнее, чем ежедневный обход.
Глубокая пагинация ограничена 50 000 строками. Для получения больших объемов сузьте запрос с помощью sort или разделите работу по доменам.
Вход только через Google, пополнение — в USDT. Начните с чекера DR, попробуйте аудит конкурентов с помощью руководства по конкурентам или прочитайте почему некоторые команды отказываются от API Ahrefs для чистой работы со ссылками.
Часто задаваемые вопросы
Платно ли за каждую строку?
Нет. Запрос оплачивается один раз, независимо от того, возвращает ли он 10 строк или 1 000.
Что происходит, когда кредиты заканчиваются?
API возвращает HTTP 402. Пополните баланс через USDT (TRC-20) на странице аккаунта и продолжайте работу.
Где найти мой ключ?
В панели управления после входа через Google.