Инструменты · key

unikalnost Проверка текста на уникальность

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

Режим
синхронный
Поиск
Яндекс, регион Россия
Стоимость
по факту: 1 лимит за каждый фрагмент текста, отправленный в Яндекс; без ответа Яндекса (код -429) не списывается

Проверка уникальности

POST /api/unikalnost

Настройки передаются в query-строке, текст — в теле формы. При проверке по URL тело не нужно, запрос можно отправить GET.

Параметры query и тело формы

  • key string обязательный
  • check_type string обязательный
    Что проверять.
    text
    текст из параметра text
    url
    текст страницы по url
  • text string
    Текст для проверки. Обязателен при check_type=text. Читается только из тела POST.
  • url string
    Страница для проверки. Обязателен при check_type=url. Совпадения с самой этой страницей не учитываются.
  • deep int
    Глубокая проверка: искать каждый фрагмент, а не каждый второй. Точнее, но дольше.
    0
    каждый второй фрагмент
    1
    каждый фрагмент
    По умолчанию 0
  • ignor_domains string
    Домены через пробел, совпадения с которыми не учитываются, например свой сайт.

Ответ

  • uniqueness float
    Процент уникальности: доля проверенных фрагментов, не найденных в выдаче.
  • urls object
    До 10 страниц с совпадениями: ключ — адрес без протокола и www, значение — процент проверенных фрагментов, найденных на ней первой.
  • repetitions array
    Неуникальные фрагменты по 6 слов.

Ошибки

КодСообщениеКогда
-50 Not set Не передан или неверен check_type, нет url при проверке по URL или нет text при проверке текста. Ключ в ответе — имя параметра; недостающих может быть несколько сразу.
-429 Yandex search is temporarily limited, try again later Поиск Яндекса не ответил на 10 % фрагментов и больше (исчерпан часовой лимит запросов). Результата нет — повторите после retry_after секунд (лимит обновляется в начале часа), не сразу.
-68, -80…-83 Not enough … limits У пользователя исчерпаны лимиты за период.
-1, -2 Access denied Ключ не передан или не найден.

Как считается

Текст делится на предложения, предложения — на фрагменты по 6 слов (предложения короче 6 слов пропускаются). Фрагмент считается неуникальным, если точный запрос по нему находит хотя бы одну страницу, кроме исключённых доменов. Короткий текст из коротких предложений может дать мало фрагментов — процент на нём неустойчив.

Если по url не удалось получить текст страницы или в тексте нет фрагментов для проверки, метод не возвращает ошибку: придёт "uniqueness": 0 и пустые urls и repetitions. Отличайте этот случай от действительно неуникального текста по пустому repetitions.

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