Як працює перевірка зовнішніх посилань на домен через API?

Надішліть домен як q до дії, наприклад overview, refdomains або backlinks, і прочитайте JSON. Безкоштовні дії не вимагають ключа. Платні дії приймають ключ у заголовку Bearer або як key= і коштують від 1 до 3 кредитів за запит, незалежно від кількості рядків.

Чи треба вставляти ключ у браузер?

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

Що станеться, коли закінчиться кредит?

API відповідає HTTP 402. Відсутній або неправильний ключ повертає HTTP 401. Сприймайте обидва як сигнали про зупинку, а не як привід для повторних спроб. Ви поповнюєте баланс USDT (TRC-20) зі сторінки облікового запису, і той самий ключ продовжує працювати.

Скільки рядків повертається за запит?

До 1 000 рядків за запит, і кожен запит нараховується один раз незалежно від кількості рядків. Пагінуйте за допомогою page та per. Глибока пагінація обмежена 50 000 рядками, тому для більших експортів звузьте запит за допомогою сортування або іншої дії.

Чи є DR таким самим числом, як у Ahrefs?

Ні. DR тут — наш власний показник: round(100 log(ref_domains + 1) / log(2 10^7)). Він схожий за духом на Ahrefs DR або Moz DA, але обчислюється з нашого власного індексу, тому порівнюйте тренди в межах одного інструмента, а не значення між інструментами.

Наскільки свіжі дані про посилання?

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

Чи є щомісячна плата або мінімум?

Без підписки та мінімуму. Кредит попередньо оплачується: 1 кредит коштує $0.0001, тому 1 000 запитів по 1 кредиту коштують $0.10. Нові акаунти отримують $100 безкоштовного кредиту, без картки, лише через вхід через Google.

Дані про посилання у форматі JSON: $100 безкоштовного кредиту, без картки, вхід через Google.

798,5 млрд індексованих зовнішніх посилань

Перевірка зовнішніх посилань на домен для вашої власної панелі керування

REST-ендпоінт, що повертає доменні посилання, якірні тексти, найкращі сторінки та DR у форматі JSON. Створіть навколо нього свій інструмент, а перші $100 запитів — за наш рахунок.

Отримайте $100 безкоштовно Прочитайте скрипт для масової оцінки DR

Чотири дії не вимагають ключа взагалі
Один запит оцінює до 2 000 доменів
Відкритий CORS, ключ у заголовку Bearer або як параметр запиту

GET /api.php?action=domainJSON

$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."

Для чого це

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

Кожна дія приймає ціль у параметрі q і повертає JSON із прапором ok. Обирайте за потребою вашого інтерфейсу, а не за тим, що звучить вражаюче.

Безкоштовні пошуки, без ключа

domain, overview, stats та suggest коштують нічого. Використовуйте їх для публічного віджета або дим-тесту в CI.

Масова оцінка DR для всього портфоліо

bulk_dr оцінює до 2 000 доменів за один запит за 1 кредит. Один нічний запит покриває великий список клієнтів.

Доменні посилання та якірні тексти

refdomains, anchors та backlinks коштують 2 кредити за запит, до 1 000 рядків кожен, з параметрами page, per, sort та order.

Перетин для таблиць прогалин

intersect приймає від 2 до 10 доменів і перелічує, хто посилається на них спільно. Два кредити, незалежно від кількості рядків.

Для кого це

Що стоїть за JSON

Цифри походять з нашого власного краулера та власного індексу посилань: 181 132 097 доменів, 2 774 625 913 посилань між доменами та приблизно 798,5 млрд зовнішніх посилань. Нічого не перепродається з третього джерела.

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

Автентифіковані відповіді містять об'єкт _credits із вартістю запиту та вашим залишком. Логуйте його. Ваш фінансист запитає, куди пішли витрати, і відповідь вже є в кожній відповіді.

Дві сторінки варто прочитати перед написанням коду: довідник поля DR пояснює, що таке оцінка від 0 до 100, а посібник з проксі-панелі керування показує, де має знаходитися ключ.

Чи потрібні числа для першого рендерингу?

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

За пропозицією за замовчуванням просто: ваш сервер викликає API, рендерить рядки, а браузер лише сортує та фільтрує. Посібник з проксі показує цей розподіл у Next.js із включеним обробником маршрутів.

Куди йде ключ, ще раз

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

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

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

Один запит, від початку до кінця

Підставте свій ключ. Значення q — це чистий домен без схеми чи шляху.

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

Чек-лист

Перед першим деплоєм у продакшн

Ключ живе у змінній середовища на сервері, ніколи в бандлі браузера
Кожна відповідь перевіряється на ok, а не лише HTTP-статус
HTTP 401 та 402 не повторюються автоматично
_credits записується у ваш власний лог при кожному запиті
Інтерфейс показує щомісячне оновлення, тому ніхто не сприймає дані як дані в реальному часі
Пагінація зупиняється на ліміті в 50 000 рядків, а не зациклюється назавжди

Сфера застосування

API даних про посилання, а не повний SEO-пакет

Дослідження ключових слів, відстеження позицій та щоденне краулення краще забезпечують Ahrefs або Semrush. Ahrefs продає одиниці API в межах підписок, починаючи від $129 на місяць за 200 000 одиниць. Цей API оцінює дані про посилання за запит.

Хороше рішення: панелі керування, аудити, масова оцінка, внутрішні інструменти
Слабке рішення: відстеження позицій, пошуковий обсяг, сповіщення про посилання в реальному часі
Дані оновлюються щомісяця, і це вказано в документації відразу

Як це працює

Від входу до нічного завдання

1
Увійдіть через Google
Сторінка облікового запису видає ваш sk_ ключ і показує стартовий баланс $100, 1 000 000 кредитів.
2
Виконайте одну безкоштовну дію
Викличте overview для домену, який ви добре знаєте. Порівняйте вивід із тим, що ви очікуєте, перш ніж будувати щось інше.
3
Напишіть шар обробки запитів
Обгорніть fetch один раз: інжекція ключа, перевірка ok, логування _credits. Дивіться примітки щодо пагінації для циклу пагінації.
4
Заплануйте його
Запускати щомісяця для глибоких витяжок, щоніці для bulk_dr. Таблиця помилок покриває, що робити, якщо нічний запуск пройшов не так.

FAQ

Питання, які розробники ставлять у першу чергу

Як працює перевірка зовнішніх посилань на домен через API?: Надішліть домен як q до дії, наприклад overview, refdomains або backlinks, і прочитайте JSON. Безкоштовні дії не вимагають ключа. Платні дії приймають ключ у заголовку Bearer або як key= і коштують від 1 до 3 кредитів за запит, незалежно від кількості рядків.
Чи треба вставляти ключ у браузер?: Ні, і не треба. CORS відкритий, тому браузер може викликати API, але ключ у клієнтському коді є публічним для кожного відвідувача. Залишайте платні запити на сервері, а фронтенд нехай спілкується з вашим власним маршрутом.
Що станеться, коли закінчиться кредит?: API відповідає HTTP 402. Відсутній або неправильний ключ повертає HTTP 401. Сприймайте обидва як сигнали про зупинку, а не як привід для повторних спроб. Ви поповнюєте баланс USDT (TRC-20) зі сторінки облікового запису, і той самий ключ продовжує працювати.
Скільки рядків повертається за запит?: До 1 000 рядків за запит, і кожен запит нараховується один раз незалежно від кількості рядків. Пагінуйте за допомогою page та per. Глибока пагінація обмежена 50 000 рядками, тому для більших експортів звузьте запит за допомогою сортування або іншої дії.
Чи є DR таким самим числом, як у Ahrefs?: Ні. DR тут — наш власний показник: round(100 log(ref_domains + 1) / log(2 10^7)). Він схожий за духом на Ahrefs DR або Moz DA, але обчислюється з нашого власного індексу, тому порівнюйте тренди в межах одного інструмента, а не значення між інструментами.
Наскільки свіжі дані про посилання?: Приблизно місяць. Індекс перебудовується приблизно раз на місяць, тому недавні посилання можуть відсутні. Якщо ваш продукт обіцяє щоденні сповіщення про нові посилання, вам потрібен вендор із щоденним краулингом і цей API для дешевих масових оцінок.
Чи є щомісячна плата або мінімум?: Без підписки та мінімуму. Кредит попередньо оплачується: 1 кредит коштує $0.0001, тому 1 000 запитів по 1 кредиту коштують $0.10. Нові акаунти отримують $100 безкоштовного кредиту, без картки, лише через вхід через Google.