Справочник
Справочник: каждое действие, его стоимость и причины сбоев
Держите эту страницу открытой во время написания скрипта для аудита. Здесь перечислены действия, цены, лимиты пагинации и две наиболее вероятные ошибки.
Базовые сведения перед таблицами
Конечная точка: https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Ключ также можно передать в заголовке Bearer. CORS открыт, поэтому скрипт может работать прямо из браузера.
Каждый ответ содержит флаг ok. Аутентифицированные ответы также содержат поле _credits, которое указывает стоимость запроса и ваш оставшийся баланс. Это упрощает контроль бюджета.
В сравнении с ценообразованием Moz API структура отличается: Ahrefs продает единицы в рамках подписок, начиная с $129 в месяц за 200 000 единиц, тогда как здесь вы платите за каждый запрос из предоплаченного баланса.
Нет уровней подписки, которые нужно проходить, и нет ежемесячного минимума. Предоплаченный баланс означает отсутствие счетов за превышение лимита. Единое правило для всех. Скрипт, который запускается раз в месяц, и скрипт для онбординга каждого клиента платят по одному и тому же правилу. Новые регистрации получают $100 бесплатных кредитов, чего достаточно примерно для 500 000 запросов стоимостью 2 кредита.
Написание первого скрипта без сюрпризов
Начинайте с малого. Скрипт, вызывающий API, легко написать, но легко превысить лимиты. Правила ниже помогут сделать первую версию надежной.
Ограничьте первый запуск одним доменом. Когда вывод покажется корректным, расширяйте список постепенно и проверяйте баланс между каждым шагом.
Страницы — единица стоимости
Один запрос оплачивается один раз независимо от количества возвращаемых строк. Загруженная страница — это еще один запрос, поэтому прохождение по большому списку стоит один заряд за страницу.
Допустим, у сайта 2 500 ссылающихся доменов, и вам нужны все. При выбранном размере страницы это несколько запросов, каждый со своей стоимостью. Посчитайте количество страниц перед запуском цикла. Выберите размер страницы, подходящий под задачу: короткий список требует одного запроса, а длинный — такого же тщательного контроля на каждой странице.
Проверяйте кредиты в каждом ответе
Каждый аутентифицированный ответ содержит _credits, который указывает стоимость запроса и остаток. Логируйте это поле, а не число, которое вы прикинули в уме.
Скрипт, выводящий баланс в лог, позволяет остановиться до того, как длинный запуск исчерпает аккаунт. Делайте проверку простой и заметной.
Используйте бесплатные запросы для тестирования плана
domain, overview, stats и suggest не требуют ключа и ничего не стоят. Используйте их, чтобы подтвердить написание домена и базовую структуру данных перед выполнением платных запросов.
Только после этого добавляйте платные запросы, по одному, для того же домена. Ошибка, пойманная на бесплатном запросе, ничего не стоит. Храните выводы бесплатных запросов в той же папке с датой, что и платные.
Бесплатные и однокредитные действия
| Действие | Стоимость | Для чего используется |
|---|---|---|
| domain | Бесплатно | Быстрый поиск DR, запрос, стоящий за проверкой на главной странице |
| overview | Бесплатно | Основные показатели для домена |
| stats | Бесплатно | Показатели самого индекса |
| suggest | Бесплатно | Поиск в стиле автозаполнения для доменов |
| bulk_dr | 1 кредит | До 2 000 доменов за запрос, GET с параметром domains= или POST-телом |
| compare | 1 кредит | До 20 доменов в сравнении |
| top | 1 кредит | Рейтинговый список из нашего индекса |
| dr_distribution | 1 кредит | Распределение DR по набору |
| tld_breakdown | 1 кредит | Ссылающиеся домены, сгруппированные по TLD |
Двух- и трехкредитные действия
| Действие | Стоимость | Для чего используется |
|---|---|---|
| refdomains | 2 кредита | Домены, ссылающиеся на цель |
| backlinks | 2 кредита | Отдельные ссылки |
| anchors | 2 кредита | Список анкоров |
| toppages | 2 кредита | Страницы, привлекающие ссылки |
| anchor_cloud | 2 кредита | Анкоры, взвешенные по частоте использования |
| intersect | 2 кредита | Кто ссылается на 2–10 доменов одновременно, для поиска ссылок-заменителей |
| search | 3 кредита | Полнотекстовый поиск по анкорам, заголовкам и URL |
| keyword | 3 кредита | Кто ссылается с точным анкором |
Один запрос оплачивается один раз независимо от количества строк, до 1 000 строк на запрос. Используйте page и per (10–5000) для навигации по результатам, сортируйте с помощью sort плюс order=asc|desc. Глубокая пагинация ограничена 50 000 записями.
Ошибки, которые вы можете увидеть
| Код HTTP | Значение | Что делать |
|---|---|---|
| 401 | Ключ отсутствует или невалиден | Проверьте параметр key или заголовок |
| 402 | Кредиты закончились | Пополните баланс через USDT (TRC-20) на странице аккаунта |
Когда запрос падает и что проверять в первую очередь
Две ошибки покрывают большинство сбоев на практике. У каждой разное решение, поэтому читайте код ошибки, прежде чем менять что-либо еще.
Неудачный запрос все равно что-то говорит. Сохраняйте URL запроса, время и тело ответа в лог, удалив ключ.
Ошибка 401 означает, что ключ не принят
Ответ 401 говорит о том, что ключ отсутствует или невалиден. Решение находится в запросе, а не в данных. Проверьте параметр key или заголовок Bearer и убедитесь, что значение скопировано полностью. Никогда не выводите ключ в лог при отладке.
Допустим, скрипт работает на вашем ноутбуке, но падает на сервере. Ошибка 401 там часто означает, что переменная окружения не была установлена на этой машине.
Ошибка 402 означает, что баланс исчерпан
Ответ 402 означает, что кредиты израсходованы. В данных ничего не неверно, и повторный запрос того же запроса завершится той же ошибкой, пока вы не пополните баланс.
Пополнения производятся в USDT по сети TRC-20 со страницы аккаунта. Проверяйте баланс перед длинным запуском, чтобы скрипт не остановился посреди списка. Установите порог предупреждения, так как раннее предупреждение обходится дешевле, чем остановленный аудит.
Повторные попытки без лишних затрат
Повторяйте только те ошибки, которые могут измениться, например таймаут. Повторный запрос 401 или 402 в цикле добавляет шум в лог и не дает данных для аудита.
Делайте паузу между попытками и сохраняйте домены с ошибками в отдельном списке, чтобы запускать их намеренно, а не случайно. Запишите правило повторных попыток в комментарий в начале скрипта, чтобы следующее изменение сохранило его.
Какое действие для какого вопроса по восстановлению
Соотнесите ваш вопрос с самым дешевым запросом, который на него отвечает.
Насколько велик ущерб?
Начните с overview, который бесплатный. Затем выполните refdomains один раз и сравните с файлом, сохраненным в прошлом месяце. Наш ежемесячный трекер показывает разницу.
Как выглядят спам-ссылки?
Используйте anchors и anchor_cloud. Странные слова, повторяющиеся на многих доменах, — это паттерн, который нужно отловить до того, как вы откроете мифы о дизавоу.
Какие доноры стоят того, чтобы их преследовать?
intersect принимает от двух до десяти доменов и возвращает сайты, ссылающиеся на несколько из них. Подставьте туда ваших конкурентов, найдите доноров, которые пропускают вас, затем оцените список с помощью bulk_dr.
Произошла ли утечка ссылок при переезде?
toppages для старого и нового домена показывает, куда ведут ссылки. Руководство по миграции использует его шаг за шагом.
Разовый аудит за четыре запроса
Этот порядок минимизирует количество платных запросов и связывает каждый с конкретным вопросом. Запускайте его один раз для каждого домена, затем повторяйте платные запросы каждый месяц с теми же настройками.
Выполните бесплатные запросы
Начните с overview и domain. Оба бесплатны, и их вывод задает масштаб для всех последующих платных запросов.
Получите ссылающиеся домены
Используйте refdomains за 2 кредита за запрос. Сначала посчитайте количество страниц, затем решите, сколько запросов вам понадобится.
Проверьте распределение анкоров
Выполните anchors или anchor_cloud по 2 кредита каждый. Ищите странные слова, повторяющиеся на многих доменах.
Оцените список кандидатов
Подайте сомнительные домены в bulk_dr за 1 кредит за запрос, который обрабатывает до 2 000 доменов. Сохраните оценки в том же файле, что и ссылающиеся домены.
Один пагинированный запрос с аннотациями
Все параметры после действия являются необязательными.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsСправедливое сравнение с альтернативой Moz API для бэклинков
Справедливые сравнения начинаются с одинаковых единиц измерения. Страницы с ценами часто скрывают единицу, поэтому запишите, за что вы фактически платите за каждый ответ, прежде чем сравнивать итоговые суммы.
В Ahrefs единицы находятся внутри подписки, которая начинается с $129 в месяц и покупает 200 000 единиц. Каждый запрос использует как минимум 50 из них. Вот в чем подвох. Сравните это с ценой за запрос, и только тогда сравнение станет осмысленным.
Тест «как есть»
Выберите пять доменов известного размера и выполните одни и те же вопросы через оба сервиса. Сравнивайте ответы, которые вам нужны, а не функции, которые вам нравятся.
Допустим, один сервис возвращает ссылающиеся домены одним запросом, а другому нужно три. Тогда стоимость за ответ важнее, чем базовая цена.
Ценообразование в одинаковых единицах
Приведите все к стоимости за ответ. Наши запросы оцениваются в кредитах по $0.0001 каждый, поэтому запрос за 2 кредита стоит $0.0002, а бесплатный запрос ничего не стоит. Допустим, ежемесячный запуск использует семь кредитов. Это $0.0007, что меньше одной десятой цента.
Включите стоимость потерь, таких как повторные запуски после сбоя запроса. Дешевый запрос, который часто падает, может оказаться дороже, чем более дорогой, который работает с первого раза.
Где полный набор функций все еще выигрывает
Исследование ключевых слов, отслеживание позиций и ежедневный краулинг выходят за рамки этого API. Если это ваши вопросы, полный набор функций отвечает на них лучше, и сравнение должно это отражать.
Используйте реестр для вопроса, на который он отвечает хорошо: как изменился ссылочный профиль и какие доноры заслуживают более внимательного изучения. Укажите пробел в своих заметках, например, здесь нет данных по ключевым словам, чтобы следующий читатель не предположил, что реестр это покрывает.
