Справочник
Справочник по API обратных ссылок: действия, стоимость и ошибки
Одна страница со всеми фактами, которые нужны мониторингу: сколько стоит каждое действие, как работает пагинация и что делает API при возникновении ошибок.

Действия по стоимости в кредитах
| Стоимость | Действия | Примечания |
|---|---|---|
| Бесплатно, без ключа | domain, overview, stats, suggest | Подходит для дашбордов и проверки DR |
| 1 кредит | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr принимает до 2,000 доменов (GET domains= или тело POST); compare — до 20 |
| 2 кредита | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect принимает от 2 до 10 доменов |
| 3 кредита | search, keyword | Полнотекстовый поиск по якорям, заголовкам и URL; keyword находит сайты, которые ссылаются с точным якорем |
Аутентификация и коды состояния
Передавайте ключ как key= или в заголовке bearer. Проверяйте HTTP-код перед парсингом тела ответа.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacПараметры и ошибки
| Параметр | Значение | Значение |
|---|---|---|
q | домен | Цель запроса |
page, per | per от 10 до 5000 | Пагинация; количество строк за вызов ограничено 1,000, глубокая пагинация — 50,000 |
sort, order | order=asc или desc | Сортировка возвращаемых строк |
ok | в каждом ответе | Успешность вызова |
_credits | только в аутентифицированных ответах | Стоимость вызова и оставшийся баланс |
| HTTP 401 | отсутствующий или неверный ключ | Проверьте ключ или заголовок |
| HTTP 402 | кредиты исчерпаны | Пополните через USDT (TRC-20) |

Проектирование вызова до планирования
Большинство проблем с API начинаются в запросе, а не в ответе. Интеграция с seo backlinks api — это в основном набор мелких решений, принимаемых до первого вызова. Сначала определитесь с ключом, размером страницы и порядком сортировки.
Держите ключ вне скрипта
Храните ключ в переменной окружения или хранилище секретов, а не в файле, который попадает в репозиторий. Передавайте его как параметр key или в заголовке bearer. Заголовок держит ключ вдали от адресов, которые часто попадают в логи.
Не вставляйте живой ключ в тикет или чат. Считайте ключ, появившийся в общем логе, скомпрометированным.
Целенаправленно выбирайте размер страницы
Параметр per варьируется от 10 до 5000, но вызов оплачивается один раз для до 1,000 строк, поэтому большие страницы означают меньше начислений. Допустим, вам нужно 3,400 строк. Это займет четыре вызова по 1,000 строк, а не 340 вызовов по 10.
Держите размер страницы одинаковым между запусками, чтобы файлы совпадали.
Фиксируйте порядок сортировки
Устанавливайте sort и order явно, а не полагайтесь на значения по умолчанию. Одинаковые параметры делают выходные данные сопоставимыми от недели к неделе, так что diff покажет реальные изменения, а не перемешанные строки.
Изменение порядка — простой способ создать ложную тревогу.
Чтение данных
Данные — это наш собственный граф ссылок: 181,132,097 доменов, 2,774,625,913 ссылок между доменами и около 798.5 миллиарда обратных ссылок. Он обновляется примерно раз в месяц. Всё, что новее этого, в нём отсутствует, поэтому seo backlinks api лучше опрашивать еженедельно.
DR = round(100 · log(ref_domains+1) / log(2·10^7)). Это логарифм. Из-за этого 100 ссылающихся доменов дают оценку 27, 1,000 — 41, а 10,000 — 55, поэтому удвоение количества ссыл добавляет лишь несколько баллов. Используйте DR для ранжирования сайтов относительно друг друга, а сырое количество — для оповещений, как в таблице уровней серьёзности.
Ценообразование предоплаченное. Подписки нет, минимума тоже. Стартовый кредит — $100, что составляет 1,000,000 кредитов. Сравните это с единицами API Ahrefs, продаваемыми в планах от $129/месяц за 200,000 единиц, с минимумом 50 единиц на запрос.
Планирование затрат — простая мультипликативная операция. Еженедельный вызов refdomains для одного сайта стоит 2 кредита × 4, или 8 кредитов в месяц, что составляет $0.0008. Десять сайтов стоят в десять раз больше. Рецепт поиска потерянных ссылок и задача конкурента используют только действия из таблицы выше.
Чтение ошибки без догадок
Код ошибки говорит о том, кто должен действовать. Читайте его именно так. Тогда ответ становится решением о маршрутизации, а не загадкой. Два кода, которые наиболее важны для мониторинга, — это 401 и 402.
401 и 402 — разные проблемы
401 означает, что ключ отсутствует или неверен, и ничего не сработает, пока кто-то не исправит это. 402 означает, что на счету не хватает кредитов, и пополнение решает проблему. Направляйте их разным владельцам, чтобы сообщение увидел нужный человек.
Отправляйте оба уведомления человеку. Монитор, который падает молча, хуже того, который вообще не запускался.
Проверяйте статус перед телом
Сначала читайте HTTP-статус, затем поле ok. Ответ может быть распарсен как JSON и всё равно содержать ошибку, поэтому проверка завершена только когда оба проходят. Логируйте статус при каждом запуске, даже успешном.
Повторяйте только то, что может восстановиться
Повторный вызов 401 тратит вызовы и забивает логи той же ошибкой. Тайм-аут сети — другое дело. Повторите его несколько раз с паузой между попытками, затем остановитесь.
Запуск, который останавливается и отправляет оповещение, полезнее, чем цикл повторных попыток, скрывающий ошибку до исчерпания баланса.
Логируйте статус при каждом запуске
Записывайте HTTP-статус и баланс в лог при каждом запуске, включая успешные. Когда через три недели запуск упадёт, эта строка будет первой, что вы захотите увидеть.
domain, overview, stats и suggest не требуют ключа и ничего не стоят. Используйте их для проверки имени домена, точного написания или примерного размера перед тем, как потратить хотя бы один кредит на платное действие.
Перед тем, как поставить вызов в cron
- Стоимость действия известна и умножается на количество запусков в месяц.
- Проверяются и код выхода, и HTTP-статус.
- 402 отправляет оповещение человеку.
- Ответы сохраняются отсортированными, чтобы diff оставался чистым.
- Частота соответствует ежемесячному обновлению.

Примечания по пагинации
Порядок имеет значение. Используйте per=1000 для снимков и каждый раз сохраняйте тот же sort и order. Если порядок изменится между запусками, diff покажет шум. Это классическая причина ложных тревог.
Большие сайты? Для сайта с более чем 1,000 ссылающимися доменами проходите страницы с page=1, page=2 и так далее. Каждая страница — отдельный оплачиваемый вызов. Глубокая пагинация ограничена 50,000 строк, что покрывает почти все обычные сайты.
Вопросы по справочнику
- Какое действие вызвать первым, если неясно, как выглядит домен?
- Начните с
overviewилиdomain. Оба бесплатны и не требуют ключа, они показывают примерный размер и базовую структуру данных. Кредиты тратьте наrefdomainsилиanchorsтолько после этого. - Сколько стоит полная проверка одного домена?
- Сложите кредиты каждого действия, затем умножьте на частоту запусков. Представьте вызов
refdomains, вызовanchorsи вызовtld_breakdownдля одного домена еженедельно. Это 2 + 2 + 1 = 5 кредитов за запуск, или $0.0005. За четыре недели это составит около $0.002. - Почему два подсчёта для одного домена могут не совпадать?
- Сравнивайте подобное с подобным: одно и то же действие, одни и те же параметры и один и тот же период обновления. Подсчёты из разных действий не взаимозаменяемы, а подсчёт, сделанный во время обновления, может отличаться от подсчёта, сделанного неделей позже.
- Как протестировать cron-задачу без траты кредитов?
- Сначала запустите бесплатные действия, чтобы проверить подключение, обработку статусов и формат вывода. Затем сделайте один платный вызов, чтобы подтвердить цифры, и ограничьте задачу одним запуском во время тестирования.
- Работает ли пагинация для сайта с более чем 1,000 ссылающимися доменами?
- Да. Используйте
pageвместе сper. Каждая страница — отдельный оплачиваемый вызов, глубокая пагинация ограничена 50,000 строк, что покрывает большинство обычных сайтов.
Монитор, переживающий плохую неделю
Монитор заслуживает доверия в те недели, когда всё идёт не так. Запланируйте медленный ответ, изменённый баланс и частичный результат до первого запуска. Это обычные события. Каждое из них должно оставлять чёткую строку в логе.
Тайм-ауты и частичные выгрузки
Установите тайм-аут для каждого вызова, чтобы один медленный ответ не держал всю задачу открытой. Если страница многоэтапной выгрузки падает, запишите, какая именно, и перезапустите с этого места. Так вы избежите двойной оплаты за уже полученные строки.
Помечайте частичный файл как частичный, а не сохраняйте его как обычный снимок. Иначе следующий diff покажет потерю, которой не было.
Проверка баланса
Читайте _credits в каждом аутентифицированном ответе и записывайте оставшийся баланс в лог. Небольшой скрипт может сравнивать его с выбранным вами порогом и отправлять предупреждение перед следующим запуском.
Допустим, порог — 500 кредитов. Еженедельный запуск, стоящий 40 кредитов, оставляет запас для пополнения до того, как ночью придёт 402.
Делайте каждую задачу скучной
Дайте каждой задаче один файл и один график. Cron-запись, делающая три вещи, может упасть тремя способами, и лог не всегда покажет, что именно произошло. Два маленьких задания легче доверять, чем одно умное.
Согласуйте график с обновлением
Согласуйте график задачи с ежемесячным обновлением, а не с часами. Ежедневный запуск возвращает тот же файл в большинство дней, что добавляет стоимость и шум без добавления информации. Еженедельного обычно достаточно.