Усунення несправностей

Як перевіряти зворотні посилання через API, коли рядки виглядають неправильно

Таблиця, орієнтована на симптоми, для моментів, коли витягування анкорів повертає менше рядків, ніж очікувалося, коштує більше, ніж планувалося, або суперечить даним минулого місяця.

Дослідницька команда Anchor Social · Оновлено 2026-10-27

Чотири глиняні труби, що живлять миску, що представляє помилки даних API та заблоковані посилання

Перевірте ці три речі насамперед

Більшість аномальних витягувань пов’язані з однією з трьох причин. Кожну з них можна перевірити менш ніж за хвилину, тому раціонально виключити їх, перш ніж витрачати годину на аналіз рядків. Перевірте ці три моменти: ключ, баланс кредитів або дату знімку.

Кожна аутентифікована відповідь містить ok та об’єкт _credits із вартістю та залишком, тому першим кроком завжди має бути виведення цих двох полів. Починайте звідти. Якщо ok дорівнює false, дані рядків ще не мають значення.

Далі перевірте місяць. Наш індекс оновлюється приблизно раз на місяць, і посилання, додане минулого тижня, може просто не потрапити в нього, що не є помилкою.

Ще одна звичка. Ведіть запис для кожного запиту з дією, номером сторінки та залишком з _credits; це спрощує відстеження пропущених 7 кредитів пізніше, замість того щоб залишати їх загадкою наприкінці місяця.

Симптом, причина, виправлення

Симптом	Ймовірна причина	Виправлення
HTTP 401	Відсутній або неправильний ключ	Надішліть `key=sk_...` або `Authorization: Bearer sk_...`; скопіюйте його зі сторінки облікового запису
HTTP 402	Кредити вичерпалися	Поповніть баланс в USDT (TRC-20) зі сторінки облікового запису та повторіть спробу
Менше рядків, ніж передбачає загальна кількість	Один запит повертає до 1000 рядків	Додайте `page=2`, `page=3`; глибока пагінація обмежується 50 000 рядками
Вартість виглядає вищою за 2 кредити	Було викликано іншу дію	`anchors` коштує 2 кредити; `keyword` та `search` — по 3; перевірте значення `action`
Загальна кількість відрізняється від минулого місяця	Індекс оновився	Порівнюйте знімки лише в межах одного інструмента та циклу оновлення
Відсутнє нове посилання	Посилання з’явилося після останнього оновлення	Зачекайте наступного щомісячного оновлення; не витягуйте дані знову, щоб його знайти
Різкий стрибок частки бренду	Посилання на весь сайт додали багато рядків	Перерахуйте, прив’язуючись до домену посилання, див. runbook
Різні дані від Ahrefs або Semrush	Різні краулинги та дати оновлення	Оберіть один джерело для відстеження трендів; використовуйте інше для точкових перевірок

Правильне читання короткого результату

Малий домен може просто мати мало анкорів. Домен, який був зареєстрований нещодавно або має мало сторінок із зовнішніми посиланнями, може генерувати короткий список з цілком звичайних причин. Короткий — не означає зламаний. Не кожен короткий список є невдачею.

Порівняйте кількість рядків із безкоштовними даними overview для того ж домену: якщо overview повідомляє про тисячі зворотних посилань, а anchors повертає сорок рядків на першій сторінці, вам, ймовірно, потрібна друга сторінка, а не тикет у підтримку. Якщо overview сам повідомляє про кілька рядків, домен молодий або малий, і витягування коректне. Порахуйте спочатку, потім скаржіться.

Зворотна ситуація також трапляється. Великі домени досягають ліміту пагінації в 50 000 рядків, тому сортируйте за стовпцем, який вас цікавить, і беріть верхню частину, або спочатку викличте anchor_cloud, щоб побачити, які терміни домінують, перш ніж перебирати все.

Переплетені глиняні шестерні різних розмірів, що показують, як налаштування впливають на результати

Налаштування сортування та пагінації змінюють те, що ви бачите

Два витягування можуть відрізнятися з причини, яка не має нічого спільного з веб-сайтом. Сортування, порядок і розмір сторінки діють разом, тому зміна одного з них може переупорядкувати весь результат, навіть якщо домен і ключ залишаються незмінними. Сортування, порядок і розмір сторінки вирішують, які рядки йдуть першими і скільки надходить за запит. Перевірте їх насамперед.

Один домен, різні лідери

Перші рядки відповідають запитуваному сорту, тому файл, відсортований одним способом, не виглядатиме як файл, відсортований інакше. Сортування змінює лідерів. Якщо один файл очолюють найбільші домені-донори, а наступний — найновіші рядки, обидва можуть бути правильними. Вкажіть сортування в назві файлу.

Швидкий тест допоможе. Спочатку запустіть його на маленькому домені, щоб тест коштував майже нічого і дав чітку відповідь щодо запиту. Викличте ту саму дію двічі з однаковими параметрами. Якщо рядки збігаються, різниця полягає в запиті, а не в даних.

Друга сторінка не є копією першої

Кожна сторінка — це окремий запит зі своєю лінійкою розрахунку, і рядки на одній сторінці не повинні повторюватися на наступній. Сторінки — це окремі запити. Коли вони повторюються, ймовірно, цикл зберігав одне й те саме значення page. Виведіть перший домен кожної сторінки, щоб підтвердити, що дані змінюються.

Зберігайте номер сторінки в журналі поруч із залишком. Цикл, який завис на другій сторінці, набагато простіше виправити, коли ви бачите точний запит, який зупинився. Журнали економлять години.

Спочатку протестуйте дві сторінки. Короткий тест після перших двох сторінок достатній. Якщо друга сторінка повторює першу, зупиніть цикл, перш ніж баланс сплатить за ті самі рядки двічі.

Виведіть поля розрахунку до всього іншого

Трьо рядковий захист, який можна вставити в cron-скрипт.

bash

R=$(curl -s "https://anchorsocial.org/api.php?action=anchors&q=example.com&per=1000&key=$KEY")
echo "$R" | jq '{ok, _credits}'
[ "$(echo "$R" | jq -r .ok)" = "true" ] || exit 1

Відновлення порядку, коли витягування виглядає неправильно

Робіть кроки зверху вниз. Кожен крок усуває одну сімейство причин, перш ніж почнеться наступний.

1
Підтвердьте успішність запиту
Прочитайте ok у першій відповіді. Якщо це false, рядки ще не мають значення.
2
Порівняйте параметри
Перевірте action, q, sort, order, per та page проти файлу, з яким ви порівнюєте.
3
Перевірте дату індексу
Запитайте, чи відбулося щомісячне оновлення між двома витягуваннями, і запишіть цю дату в таблицю.
4
Перестворіть запит з нуля
Запишіть запит знову, параметр за параметром, щоб виявити одруківку, яку може приховати скопійований URL.

Глиняні конверти під збільшувальним склом, що показують тонкі відмінності для вирішення суперечок

Вирішення суперечки з файлом минулого місяця

Коли два файли суперечать один одному, питання рідко полягає в тому, хто правий. Більшість розбіжностей викликано зміною налаштування, яке ніхто не записав, тому журнал важливіший за пам’ять. Йдеться про те, яка частина запиту змінилася між ними. Подивіться на запит спочатку. Пройдіть три перевірки по порядку, і більшість суперечок закінчаться на першій.

Почніть з дати індексу

Індекс оновлюється приблизно раз на місяць, і це оновлення — перше, що слід виключити. Посилання, яке стало активним після останнього оновлення, не з’явиться в жодному файлі, і повторне витягування того ж дня не виправить це. Дати оновлення пояснюють прогалини.

Позначте кожен файл. Файл, названий з датою витягування та циклом оновлення, відповідає на найпоширеніше запитання, перш ніж хтось мусить ставити його на зустрічі. Запишіть цикл оновлення поруч із назвою кожного файлу. Тоді прогалина читатиметься як прогалина в часі, а не в веб-сайті.

Тримайте дати оновлення разом в одному стовпці, а не розкиданими по нотатках. Читач, який бачить дати поруч із загальними показниками, рідко потребує другого запитання. Це економить одне запитання.

Порівнюйте подібне з подібним

Два файли порівнянні лише тоді, коли збігаються дія, домен, сортування та значення per. Якщо сортування відрізняється, провідні рядки будуть різними, навіть якщо всі загальні показники збігаються, і це може виглядати як реальна зміна в профілі. Поєднання файлу anchors із файлом backlinks — поширений спосіб вигадати падіння, якого не було. Спочатку мають збігатися налаштування.

Якщо параметри збігаються, а загальні показники все одно відрізняються, ця різниця варта уважнішого розгляду, і журнал підкаже, з чого почати. Тоді прочитайте журнал.

Виділіть значенню per окремий стовпець, оскільки воно змінює кількість рядків, що надходять за запит, і, отже, кількість запитів, які коштує витягування. Тримайте його видимим.

Коли рядки змістилися, а не зникли

Після зміни домену або редизайну посилання може все ще існувати і вказувати на нову адресу. Старі хости зберігають посилання. Порівняйте топ сторінок для старого та нового хоста, перш ніж вважати посилання втраченим. Чек-лист міграції розглядає це поєднання.

Зафіксуйте обидві сторони. Запишіть обидві адреси в один рядок, щоб перехід залишався видимим у таблиці.

Витрати, які дивують людей

Рахунок, що зростає швидше за план, зазвичай має одну причину. Багато команд помічають вищий рахунок лише в кінці місяця, тому тижневий огляд поточної суми виявляє відхилення раніше. Це дія. Багато читачів питають, як перевіряти зворотні посилання, не переплачуючи, і відповідь починається з назви дії. Перевіряйте залишок у кожній відповіді та ведіть поточну суму поруч із таблицею.

Баланс, що висихає швидше, ніж планувалося

Назви дій мають значення. Зазвичай винна назва дії. anchors коштує 2 кредити, тоді як keyword і search — по 3, тому скрипт, який змінив дію, тихо збільшив рахунок. Перевірте значення action в запиті перед першим великим запуском.

Відстежуйте відхилення. Ведіть поточну суму _credits в таблиці. Мале відхилення щодня легко помітити там, задовго до кінця місяця.

402 посередині циклу

402 означає, що баланс вичерпався. Зупиніть цикл. Запити, які вже обслуговувалися, були оплачені, тоді як наступний запит не вдається. Зупиніть цикл, поповніть баланс в USDT (TRC-20) зі сторінки облікового запису та продовжте з тієї сторінки, на якій зупинилися.

Точка відновлення корисна лише тоді, коли вона записана. Зберігайте номер сторінки в журналі, щоб перезапуск не був вгадуванням. Запишіть сторінку.

Читання результату, який занадто великий

Раптовий ріст підрахунку вартий огляду джерела, перш ніж він стане історією. Одне шаблонне посилання може додати тисячі рядків, і рядок із загальною кількістю не скаже, чи це один сайт, чи багато. Рядки можуть бути правильними, а причина — в одному домені, а не в цілому профілі. Перевірте джерело спочатку.

Посилання в підвалі всього сайту за великою кількістю

Одне шаблонне посилання, яке з’являється на тисячах сторінок одного сайту, може пояснювати великий блок рядків. Згрупуйте витягування за доменом посилання і подивіться, яку частку загальної суми займає один сайт. Спочатку згрупуйте, потім судіть.

Якщо один домен домінує, загальна сума — це факт про цей сайт, і аналіз слід сформулювати відповідним чином. Сформулюйте його так.

Рядки з домену, якому ви ніколи не посилалися

Дивні анкори потребують перевірки. Їх наявність не доводить, що щось не так, але це означає, що рядок заслуговує на таке ж читання, як і будь-який інший рядок у вашому аналізі. Незнайомі домені-донори з нерелевантними анкорами можуть походити від скрапера або зламаної сторінки. Відкрийте одну з посилальних сторінок як відвідувач, перш ніж припускати, що рядки належать вашому профілю.

Запишіть домен, дату та анкор у таблицю та збережіть сирій JSON, щоб пізніший огляд мав докази. Докази переважають пам’ять.

Якщо таблиця не допомогла

Викличте безкоштовну дію, таку як overview, для того ж домену; якщо це працює, проблема в ключі
Підтвердьте, що ви ввели чистий домен у q, без шляху
Збережіть сирій JSON перед зміною чогось
Перевірте баланс у панелі керування проти _credits
Зв’яжіться з нами зі своєї сторінки облікового запису з дією та міткою часу

Швидкі відповіді

Чи коштує кредити невдалий запит?

401 або 402 повертається до того, як будуть обслуговані будь-які рядки. Кожен успішний запит нараховується один раз, незалежно від кількості рядків до 1000. Перевірте _credits у відповіді, щоб підтвердити, скільки коштував конкретний запит.

Чому два витягування в один день можуть відрізнятися?

Вони не повинні, оскільки індекс змінюється лише під час щомісячного оновлення. Якщо вони відрізняються, спочатку порівняйте параметри сортування та пагінації, потім свій ключ і дію. Сторінка безкоштовної перевірки охоплює, що повертають безключові запити.