Как работает проверка обратных ссылок на домен через 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 бесплатны. Используйте их для публичного виджета или smoke-теста в 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 с стоимостью запроса и вашим оставшимся балансом. Логируйте его. Бухгалтерия спросит, куда ушли средства, и ответ уже есть в каждом ответе API.

Две страницы стоит прочитать перед написанием кода: справочник по полю DR объясняет, что такое оценка от 0 до 100, а руководство по прокси панели управления показывает, где должен находиться ключ.

Нужны ли числа для первого рендеринга?

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

Наша рекомендуемая схема проста: ваш сервер вызывает API, рендерит строки, а браузер только сортирует и фильтрует. Руководство по прокси показывает этот разделение в Next.js с включённым обработчиком маршрутов.

Куда помещать ключ, ещё раз

Ключ никогда не должен находиться на странице, которую может открыть посетитель. Храните его в переменной окружения на сервере и выполняйте запрос из кода, который работает там, где хранится этот секрет.

Инструменты, обещающие скрыть ключ в бандле, скрывают его от случайного читателя, а не от любого, у кого открыта вкладка Network.

Серебряные цепи, соединяющие каменные столбы через туманную долину, символизирующие обратные ссылки на домен

Один запрос от начала до конца

Замените ключ на свой. Значение 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.