Документація
Довідка по ендпоінтах та ціни
Один URL, багато дій. Ось повний спектр можливостей.
Дослідницька команда SEOCheck ·

Дії та вартість
| Дія | Кредити | Що повертає |
|---|---|---|
| domain | безкоштовно | Базовий запис та DR для одного домену |
| overview | безкоштовно | Зведені дані про посилальний профіль домену |
| stats | безкоштовно | Статистика по всьому індексу |
| suggest | безкоштовно | Пропозиції доменів під час введення |
| bulk_dr | 1 | DR для до 2 000 доменів |
| compare | 1 | Порівняння поруч для до 20 доменів |
| top | 1 | Топ доменів |
| dr_distribution | 1 | Розподіл DR серед посилальних доменів |
| tld_breakdown | 1 | Посилання за доменами верхнього рівня |
| refdomains | 2 | Посилальні домени |
| backlinks | 2 | Окремі зовнішні посилання |
| anchors | 2 | Анкорні тексти |
| toppages | 2 | Найбільш посилані сторінки |
| anchor_cloud | 2 | Ваги анкору |
| intersect | 2 | Спільні посилальники для 2–10 доменів |
| search | 3 | Повнотекстовий пошук по анкорам, заголовках та URL |
| keyword | 3 | Хто посиланий з точним анкором |
Автентифікація та формат
Базовий URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Віддаєте перевагу заголовкам? Надішліть Authorization: Bearer sk_... замість цього.
Цей API аналізу зовнішніх посилань відповідає у форматі JSON і підтримує крос-доменні запити, тому браузер може звертатися до нього напряму. Кожна відповідь містить поле ok. Аутентифіковані відповіді також містять _credits, який вказує вартість запиту та ваш залишок.
Помилки чіткі. HTTP 401 означає, що ключ відсутній або неправильний. HTTP 402 означає, що баланс вичерпано. Обидва випадки легко обробляти, і жоден з них не слід повторювати в циклі.
Перед першим платним запитом
- Запустіть
overviewдля домену, який ви знаєте. Це безкоштовно. - Перевірте, що ваш ключ працює, зробивши один запит за 1 кредит, наприклад
compare. - Прочитайте
_creditsу відповіді та переконайтеся, що вартість відповідає таблиці вище. - Налаштуйте сповіщення в скрипті на HTTP 402, щоб вичерпання балансу не призводило до тихих збоїв.
Пагінація та сортування
Кількість рядків за запит може сягати 1 000. Вказуйте менше або більше за допомогою параметра per (від 10 до 5000), переміщайтеся за допомогою page та сортируйте за допомогою sort та order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Параметри, що змінюють відповідь
Кожна дія приймає ті ж два базові параметри, action та q, а також короткий набір опцій. Прочитайте їх спочатку. Більшість помилок виникають через опції, які здаються необов'язковими, але змінюють вартість або структуру рядків. Читайте опції, перш ніж копіювати запит з форуму чи блогу.
Приклади нижче передбачають наявність ключа в параметрі key. Замініть заглушку на свій ключ. Зберігайте ключ у змінній середовища, а не у файлі, який потрапить у репозиторій. Кожен приклад у цьому довіднику API аналізу зовнішніх посилань використовує той самий базовий URL.
Пагінація з page та per
Опція per встановлює кількість рядків, що повертаються, від 10 до 5000. Опція page дозволяє переміщатися по набору даних. Запит, який просить 500 рядків, а потім page 2, повертає наступний блок, а не наступну порцію тих самих рядків.
Глибока пагінація обмежується 50 000 рядками. Якщо завданню потрібно більше, звузьте запит за допомогою sort або розділіть роботу за доменами, щоб кожен запит залишався в межах ліміту.
Сортування з sort та order
Сортируйте на сервері, а не в своєму скрипті. Запит sort=dr&order=desc повертає найсильніші посилальні домени першими, тому рядки, які вас цікавлять, потрапляють на першу сторінку. Фільтрація після повного завантаження марнує час та кредити.
Використовуйте order=asc, коли вам потрібні найслабші рядки, наприклад, щоб знайти слабкі посилання або виявити різке падіння профілю.
Списки: bulk_dr, compare та intersect
Дії зі списками приймають кілька доменів за один запит. bulk_dr приймає до 2 000 доменів за один кредит, через рядок запиту GET або тіло POST. compare приймає до 20 доменів, а intersect — від двох до десяти.
Оскільки ціна не залежить від кількості рядків, довгий список в одному запиті дешевший, ніж багато коротких запитів. Скажімо, ви перевіряєте 1 500 сайтів-кандидатів у понеділок. Це один запит, а не 1 500.
Запити search та keyword коштують більше
Дія search виконує повнотекстовий пошук по анкорам, заголовках та URL. Дія keyword запитує, хто посиланий з точним анкором. Обидва кошують три кредити за запит, тому використовуйте їх для відповіді на конкретне запитання, а не для перегляду.
Вибір per та page для першого запиту
Для першого погляду на новий домен почніть з малого per, наприклад 50. Ви побачите структуру рядків, імена полів та вартість у короткій відповіді. Збільшуйте per лише тоді, коли переконаєтеся, що рядки саме ті, що вам потрібні. Така ж звичка працює для кожної дії в таблиці вище.
Поширена помилка — запитувати 5000 рядків з першої спроби, а потім відкидати більшість з них. Відповідь стає більшою, очікування довшим, а заощадження, на які ви розраховували, не з'являються.
Читання лічильника кредитів
Кожна аутентифікована відповідь закінчується блоком _credits, який вказує вартість запиту та ваш баланс після нього. Логуйте його. Підсумуйте в кінці місяця, і ви знатимете свій реальний рахунок до центів.
Орієнтовний бюджет допомагає. Тисяча запитів refdomains коштує 2 000 кредитів, що становить $0.20. Тисяча запитів search коштує 3 000 кредитів, або $0.30. Щоденний запуск bulk_dr зі списком з 2 000 доменів коштує 1 кредит, тобто близько $0.003 на місяць.
Порівняно з планами, які починаються від $129 на місяць за 200 000 одиниць API, як перелічує Ahrefs, структура рахунку інша. Дивіться порівняння, щоб дізнатися, чому.

Читання помилок та поля _credits
Відповідь може провалитися двома різними способами, і ваш код має обробляти їх по-різному. Це різні проблеми. Неправильний ключ — це проблема конфігурації. Пустий баланс — це проблема оплати. Обробка обох як однієї загальної помилки приховує, який саме виправлення потрібне.
Спочатку прочитайте поле ok. Потім прочитайте блок _credits. Тільки після цього дивіться на рядки, оскільки відсутній або короткий результат легше пояснити, коли ви вже знаєте, скільки коштував запит.
Обробляйте 401 та 402 окремо
HTTP 401 означає, що ключ відсутній або неправильний. Зупиніть завдання та виправте ключ. HTTP 402 означає, що баланс вичерпано. Поповніть баланс на сторінці облікового запису, а потім продовжуйте. Повторна спроба 401 ніколи не допоможе, і повторна спроба 402 без поповнення також ні до чого не призведе.
Логуйте баланс до та після запуску
Запишіть баланс _credits на початку запуску та в кінці. Різниця має збігатися з тим, що ви очікували від зроблених запитів. Більший стрибок означає, що цикл виконався частіше, ніж ви планували.
Для швидкої перевірки помножте кількість запитів на їх вартість у кредитах. Якщо відповідь 40, а баланс впав на 4 000, щось не так зі скриптом, а не з прайс-листом.
Перевірте рядки, які ви запитували
Успішна відповідь з меншою кількістю рядків, ніж очікувалося, не є автоматично помилкою. Маленький домен може просто мати мало посилань. Порівняйте кількість рядків із значенням per, яке ви надіслали, і сприймайте розрив як питання, на яке треба відповісти, а не як помилку, яку треба приховати.
Спочатку тестуйте дешеві запити
Перш ніж підключити запит до завдання, запустіть його вручну один раз із найменшими розумними параметрами. Перевірте відповідь, імена полів та значення _credits. Завдання, яке ламається на другому рядку, набагато складніше налагоджувати, ніж запит, який провалився з першої спроби.
Перша сесія з API
Чотири запити, у порядку, щоб кожен наступний запит був тим, який ви вже розумієте. Лише перший є безкоштовним, і це навмисно.
Запустіть overview для домену, який ви знаєте
Це безкоштовно і не вимагає ключа. Порівняйте зведені дані з тим, що ви бачите в Search Console та на самому сайті, щоб знати, як виглядає нормальна відповідь.
Протестуйте ключ одним запитом за 1 кредит
Надішліть compare з вашим доменом та одним конкурентом. Підтвердіть, що поле ok є істинним, а _credits показує вартість у один кредит.
Отримайте список за 2 кредити з малим per
Запитайте refdomains з per=50 та sort=dr. Переконайтеся, що кількість рядків та вартість у кредитах відповідають таблиці вище.
Запишіть вартість у лог
Зафіксуйте баланс до та після. Відтепер кожен скрипт, який ви пишете, починається з цієї звички, і несподіваний рахунок стає рядком у журналі, а не загадкою.
Ціни
Попередньо оплачені кредити. Один кредит — $0.0001. Немає підписки та щомісячного мінімуму.
Оплата за використання
$0.10за 1 000 запитів по 1 кредиту
- $100 безкоштовних кредитів при реєстрації
- Картка не потрібна
- Поповнення через USDT (TRC-20)
- Рахунок нараховується один раз за запит, а не за рядок
Ліміти, які варто знати
Індекс охоплює 181 132 097 доменів та 2 774 625 913 посилань між доменами. Він оновлюється приблизно щомісяця. Це повільніше, ніж щоденний краулінг.
Глибока пагінація обмежується 50 000 рядками. Для більших обсягів звузьте запит за допомогою sort або розділіть за доменами.
Вхід лише через Google, а поповнення — через USDT. Почніть з чекера DR, спробуйте аудит конкурента з гідом по конкурентах або прочитайте чому деякі команди відмовляються від API Ahrefs для чистої роботи з посиланнями.
Часті запитання
Чи плачу я за рядок?
Ні. Запит нараховується один раз, незалежно від того, повертає він 10 рядків чи 1 000.
Що станеться, коли кредити закінчаться?
API поверне HTTP 402. Поповніть баланс через USDT (TRC-20) на сторінці облікового запису та продовжуйте.
Де знайти мій ключ?
У панелі керування після входу через Google.