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

Дії за вартістю в кредитах
| Вартість | Дії | Примітки |
|---|---|---|
| Безкоштовно, без ключа | domain, overview, stats, suggest | Підходить для дашбордів та перевірки DR |
| 1 кредит | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr приймає до 2,000 доменів (GET domains= або POST body); 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 кредитів. Порівняйте це з одиницями Ahrefs API, які продаються в планах від $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-запис, який робить три речі, може збійти трьома способами, і лог не завжди може сказати, який саме. Дві невеликі задачі легше довіряти, ніж одна хитра.
Відповідайте графік оновленню
Відповідайте графік задачі щомісячному оновленню, а не годиннику. Щоденний запуск повертає той самий файл більшість днів, що додає витрати та шум без додавання інформації. Зазвичай достатньо щотижневого.