Перейти к содержимому
SEO Uptr
SEO UptrЗарегистрироваться

Справочник

Справочник по API обратных ссылок: действия, стоимость и ошибки

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

Каменный мост через реку, под которым плывёт маленькая лодка

Действия по стоимости в кредитах

1 кредит = $0.0001. Каждый вызов оплачивается один раз независимо от количества строк, до 1,000 строк за вызов.
СтоимостьДействияПримечания
Бесплатно, без ключаdomain, overview, stats, suggestПодходит для дашбордов и проверки DR
1 кредитbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr принимает до 2,000 доменов (GET domains= или тело POST); compare — до 20
2 кредитаrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect принимает от 2 до 10 доменов
3 кредитаsearch, keywordПолнотекстовый поиск по якорям, заголовкам и URL; keyword находит сайты, которые ссылаются с точным якорем

Аутентификация и коды состояния

Передавайте ключ как key= или в заголовке bearer. Проверяйте HTTP-код перед парсингом тела ответа.

bash
# 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, perper от 10 до 5000Пагинация; количество строк за вызов ограничено 1,000, глубокая пагинация — 50,000
sort, orderorder=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-запись, делающая три вещи, может упасть тремя способами, и лог не всегда покажет, что именно произошло. Два маленьких задания легче доверять, чем одно умное.

Согласуйте график с обновлением

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