Довідник
Довідник: кожна дія, її вартість, способи виникнення помилок
Тримайте цей файл відкритим під час написання скрипта для аудиту. Тут перелічено дії, ціни, ліміти пагінації та дві помилки, з якими ви, ймовірно, зіткнетеся.
Основи перед таблицями
Ендпоінт має вигляд 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. Дивні слова, які повторюються на багатьох доменах, — це шаблон, який потрібно виявити, перш ніж відкривати міфи про disavow.
Які донори варті того, щоб їх переслідувати?
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. Якщо це ваші питання, повний пакет відповідає на них краще, і порівняння має це вказувати.
Використовуйте реєстр для питання, на яке він добре відповідає: як змінився профіль посилань і які донори варті уважнішого огляду. Вкажіть прогалину у своїх нотатках, наприклад, тут немає даних по ключових словах, щоб наступний читач не припустив, що реєстр це покриває.
