unikalnost Проверка текста на уникальность
Проверяет текст или содержимое страницы на уникальность: режет текст на фрагменты по 6 слов, ищет каждый в Яндексе точным запросом и считает долю фрагментов без совпадений. Метод синхронный — ответ приходит сразу, но для длинного текста запрос может идти десятки секунд. В интерфейсе — Проверка текста на уникальность.
- Режим
- синхронный
- Поиск
- Яндекс, регион Россия
- Стоимость
- по факту: 1 лимит за каждый фрагмент текста, отправленный в Яндекс; без ответа Яндекса (код -429) не списывается
Проверка уникальности
/api/unikalnost
Настройки передаются в query-строке, текст — в теле формы. При проверке по URL тело не нужно, запрос можно отправить GET.
Параметры query и тело формы
-
keystring обязательныйКлюч API из настроек аккаунта. -
check_typestring обязательныйЧто проверять. -
textstringТекст для проверки. Обязателен приcheck_type=text. Читается только из тела POST. -
urlstringСтраница для проверки. Обязателен приcheck_type=url. Совпадения с самой этой страницей не учитываются. -
deepintГлубокая проверка: искать каждый фрагмент, а не каждый второй. Точнее, но дольше. -
ignor_domainsstringДомены через пробел, совпадения с которыми не учитываются, например свой сайт.
Ответ
-
uniquenessfloatПроцент уникальности: доля проверенных фрагментов, не найденных в выдаче. -
urlsobjectДо 10 страниц с совпадениями: ключ — адрес без протокола иwww, значение — процент проверенных фрагментов, найденных на ней первой. -
repetitionsarrayНеуникальные фрагменты по 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.