Перейти к содержимому
SEO Tools AI
SEO Tools AIЗарегистрироваться

Справочник

Поля оценки инструментов по порядку

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

Исследовательская команда SEO Tools AI ·

Столбцы вкратце

Стоимость указана за вызов, а не за строку. Один вызов возвращает до 1 000 строк.
СтолбецЗаполняется черезКредитыОбновление
drbulk_dr, до 2 000 доменов1Ежемесячно
dr_checked_onВаша собственная задача, в день получения данных0При каждом запуске
ref_domainsrefdomains, сортировка по вашему выбору2Ежемесячно, только для топ-списков
top_anchorsanchors2Ежеквартально
top_pagestoppages2Ежеквартально
overview_bloboverview (бесплатно, без ключа)0По запросу
rival_overlapintersect, от 2 до 10 доменов2При добавлении инструмента

Столбцы, которые заслуживают своего места

Начните с двух. dr — ключ сортировки, а dr_checked_on — столбец честности.

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

Относитесь ко всему остальному как к дополнительным. Сайт сравнения, который показывает количество ссылающихся доменов рядом с рейтингом, дает читателям второе число для перекрестной проверки, что полезнее, чем просто красивый значок. Наша страница инструмента анализа обратных ссылок показывает, как это выглядит на фоне других проверщиков.

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

Столбцы для ссылок, которые выдает каталог

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

Начните с поля «да/нет», которое фиксирует наличие обратной ссылки. Перед тем как записать его, проверьте сайт указанного инструмента самостоятельно, потому что запомненный ответ — это первое, что может пойти не так в списке из нескольких сотен строк.

Столбец взаимных ссылок

Добавьте reciprocal_link как столбец «да/нет», который указывает, ссылается ли сайт указанного инструмента обратно на вас. Представьте, что вы поддерживаете 300 инструментов, и 40 из них запросили ссылку в обмен. Этот столбец покажет, какие списки основаны на услуге, и сделает это еще до того, как читатель спросит.

Исключите этот столбец из сортировки по оценке. Он описывает отношение, а не инструмент, поэтому его включение в рейтинг усложнило бы объяснение порядка позже.

Столбец статуса для публикуемых ссылок

Записывайте outbound_status с HTTP-статусом каждой публикуемой ссылки, а также датой последней проверки. Список, возвращающий 404, — это нарушенное обещание читателю, и никто другой не заметит это за вас.

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

Зафиксируйте данное обещание

Когда каталог просит ссылку в обмен, запишите дату, страницу и точную формулировку запроса в столбец link_note. Обычная заметка занимает минуту на запись и экономит споры через полгода.

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

Отделение платного размещения

Если размещение было оплачено, сохраните значение placement рядом с оценкой и никогда не позволяйте оценке единолично определять порядок. Высокий dr не должен быть единственной причиной, по которой платная строка находится выше лучшей.

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

Параметры запроса, которые вы действительно будете использовать

Это параметры из API в том порядке, в котором они нужны задаче синхронизации.

text
action   what to do: domain, overview, bulk_dr, refdomains, anchors ...
q        one domain, for single-domain actions
domains  comma list, for bulk_dr (GET) or send it as a POST body
key      your sk_ key, or use the Authorization: Bearer header
page     which page of rows
per      rows per page, 10 to 5000, up to 1,000 rows per billed call
sort     column to sort by
order    asc or desc

Именование и типы, которые хорошо стареют

Называйте столбцы в зависимости от того, что они содержат, а не от имени вендора. dr подходит для наших данных, но если позже вы добавите второй метрик, dr_ours и da_moz избавят вас от миграции.

Храните рейтинг в виде целого числа от 0 до 100, дату в виде ISO-строки, например 2026-10-01, а количества — в виде целых чисел. Текстовый столбец, содержащий 1.2k, — это ловушка для первого, кто попытается его отсортировать.

Также храните столбец source со short значением, например seotoolsai. Это стоит несколько байт и отвечает на вопрос, который задаст каждый будущий редактор.

Два поля ответа, которым можно доверять

Каждый ответ содержит ok. Аутентифицированные также содержат _credits с стоимостью этого вызова и вашим оставшимся балансом. Логируйте оба значения. Перед тем как мапить любое другое поле в столбец, сделайте один бесплатный вызов domain и прочитайте JSON самостоятельно.

Настройка таблицы за пять шагов

01

Сначала назовите столбцы

Напишите список столбцов, прежде чем касаться API-ключа, и назовите каждый столбец в зависимости от того, что он содержит. Исключите имена вендоров из названий столбцов, чтобы добавление нового метрика позже не потребовало переименования.

02

Сделайте один бесплатный вызов

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

03

Добавьте оценку и дату

Сохраняйте dr как целое число, а dr_checked_on как ISO-дату. Эти два столбца — минимум для оценки, которой читатель может доверять.

04

Протестируйте на двадцати строках

Отправьте bulk_dr для двадцати списков, которые вам известны. Сравните три результата вручную с бесплатным действием domain, и только затем запускайте полный список.

05

Добавьте столбцы детализации для избранных строк

Ссылающиеся домены и якоря стоят 2 кредита за вызов, поэтому запрашивайте их только для списков, которые вы показываете детально. Оценки в 1 кредит все еще покрывают все остальные строки.

Рабочий пример: гипотетическая запись списка

Это выдуманный пример, а не реальный список. Представьте каталог под названием ToolShelf со списком для вымышленного продукта example-seo.test.

Его запись содержит dr 41, dr_checked_on 2026-10-01 и ref_domains 1 000. Это соответствует публичной формуле, так как log(1001), деленный на log(20 000 000) и умноженный на 100, округляется до 41.

Через месяц задача повторно запрашивает данные и обнаруживает 1 800 ссылающихся доменов, поэтому рейтинг становится 45. Изменяются только dr и дата. Текст обзора, скриншоты и заметки редактора остаются точно такими же, как были написаны, потому что оценка не затрагивает их.

Какие списки заслуживают оценки и насколько глубоко

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

Оценивайте каждую строку, даже те, которые скрыты от читателей. Скрытый список все еще нуждается в значении, когда кто-то фильтрует бэк-офис, а пустая ячейка там выглядит как пропущенная проверка, а не как выбор.

Два списка на одном домене

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

Добавьте краткую текстовую заметку, например shares domain, ко второй строке. Без нее редактор увидит два одинаковых числа и предположит, что одно из них — ошибка копирования.

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

Тратьте вызовы детализации там, где смотрят читатели

Вершина категории — это место, где количество ссылающихся доменов меняет решение. Начните с вызовов за 2 кредита там и оставьте длинный хвост на уровне dr.

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

Сохраняйте исходный ответ один раз

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

Это также дает вам запись, на которую можно указать, когда рейтинг выглядит неверно. Сравните сохраненный ответ с текущим, прежде чем вручную изменять какой-либо рейтинг.

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

Запускайте обновление в фиксированном порядке

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

Если задача прерывается посередине, журнал показывает, где продолжить. Строки, которые уже содержат дату этого месяца, можно пропустить, и ничего не будет оплачено дважды.

Вопросы по полям

Должен ли я хранить исходный JSON для каждого списка?

Да, один раз за обновление. Храните его в одном текстовом или JSON-столбце, затем выводите dr и другие отображаемые поля из него. Когда вы меняете то, что показываете, вы можете восстановить страницы, не вызывая API снова и не платя дважды.

Что произойдет, если домен не в индексе?

Не угадывайте рейтинг. Оставьте ячейку dr пустой и не показывайте значок для этого списка. Наш индекс содержит 181 132 097 доменов, что много, но не весь веб, и пустое значение более честно, чем ноль.

Мне нужны все эти поля на публичной странице?

Нет. Показывайте рейтинг и его дату, а также количество ссылающихся доменов для избранных списков. Остальное храните в бэк-офисе для сортировки, аудита и выявления списков, чьи цифры скачут от месяца к месяцу.