API Адвего Лингвиста

На запросы отвечает сервис по адресу https://api.advego.com/json/

API Лингвиста доступен пользователям, на символьном счету которых находится не менее 100 тысяч символов.

Пополнение символьного счета: https://advego.com/antiplagiat/buy/

Базовая стоимость проверки - 1,2 руб. / 0,01 у. е. за 1000 символов с пробелами.

При покупке пакета символов доступны скидки до 50%.

-----

Токен для API Лингвиста - общий с токеном для проверки на антиплагиат (рекомендуем обновить перед первым использованием): https://advego.com/antiplagiat/api/

Токен не имеет срока действия и может быть перегенерирован на той же странице.

Токен должен передаваться в каждом запросе.

-------

В качестве протокола используется json-rpc 2.0. Стандартный запрос выглядит следующим образом (id используется для сопоставления запроса с ответом):

{"jsonrpc": "2.0", "method": "...", "params": { …. }, "id": 1 }

-------

Форматирование текста для проверки:

• Для передачи переноса строк необходимо использовать тег \n
• HTML-теги автоматически удаляются при проверке, в проверяемом объеме не учитываются и на качество проверки не влияют, но остаются видны в полном тексте проверки на сайте.

Важно! Если в проверяемом тексте встречаются кавычки вида "", их необходимо экранировать:

"слово" -> \"слово\"

<a href="https://advego.com">АНКОР</a> -> <a href=\"https://advego.com\">АНКОР</a>

Также нужно экранировать символ обратного слеша \, если он используется сам по себе:

\слово -> \\слово

Не нужно экранировать символ \, если он экранирует кавычки или является частью тега переноса строки \n.

-------

Методы

-------

1. Добавление текста на проверку

TextQualityPack.checking_text

Параметры:

• token — токен для авторизации;
• text — текст для проверки; Важно! Если в тексте есть переносы строк (абзацы, списки и т. п.) их нужно заменить на символ "\n" без кавычек.

-----

Пример запроса:

{
"jsonrpc": "2.0",
"method": "TextQualityPack.checking_text",
"id": 13,
"params": {
"appid": "",
"token": "TOKEN",
"text": "<p>Заказывайте тексты, фото и видео за <a href=\"https://advego.com\">минимум действий</a> — система сама найдет исполнителей, и вы получите качественный уникальный контент в кратчайшие сроки:</p>"
}
}

-----

Ответ:

{
 "jsonrpc": "2.0",
 "result": {
 "result": {
 "linguist": {
 "id_task": "6e80a6afe18890902e50f0d9398c3559",
 "id_text_quality_pack": "140399",
 "id_text_quality": "150518"
 },
 "seo": {
 "id_task": "dd666b7f8656ca67bf83ca5f064a991d",
 "id_text_quality": "150519",
 "id_text_quality_pack": "140399"
 }
 },
 "id_text_quality_pack": "140399"
 },
 "id": 13
}

Для дальнейших запросов (выгрузка результатов и т. п.) необходимо использовать значение "id_text_quality_pack": "140399".

-----

2. Выгрузка списка проверок (выдает полные данные всех доступных проверок):

TextQualityPack.get_list

Параметры:

• token — токен для авторизации;

• page_num — номер страницы;

• page_size — размер страницы;

• reverse — обратный порядок.

-----

Пример запроса:

{
"jsonrpc": "2.0",
"method": "TextQualityPack.get_list",
"id": 1,
"params": {
"appid": "",
"token": "TOKEN",
"page_num": 1,
"page_size": 10,
"reverse": 1
}
}

Ответ:

{
 "result": {
 "reverse": 1,
 "page_size": "10",
 "size": "1",
 "list": [
 {
 "result": "{\"id_payer\": 16830831, \"was_paid\": 1, \"paid_money\": 0, \"need_symbols\": 0, \"paid_symbols\": 154, \"payment_method\": \"0\"}",
 "state": 2,
 "date": "6 мин. назад",
 "header": "<p>Заказывайте тексты, фото и видео за <a href=\"https://advego.com\">минимум действий</a> — система ",
 "id_text_quality_pack": "140399",
 "create_date": "2025-11-01 15:19:10.172386",
 "list": [
 {
 "create_date": "2025-11-01 15:19:10.236757",
 "state": 2,
 "result": {
 "non_stop_words_cnt": 6,
 "words_total": 21,
 "syntax_errs": "контент",
 "phrases": [],
 "toshnota_2": "0.0",
 "toshnota_words_cnt": 0,
 "handler_": 1,
 "stop_words_cnt": 6,
 "lang_name": "Russian - Русский",
 "stop_words": [
 {
 "tf": "9.52",
 "word": "и",
 "cnt": 2
 },
 {
 "tf": "4.76",
 "word": "в",
 "cnt": 1
 },
 {
 "tf": "4.76",
 "cnt": 1,
 "word": "вы"
 },
 {
 "tf": "4.76",
 "cnt": 1,
 "word": "за"
 },
 {
 "cnt": 1,
 "word": "сам",
 "tf": "4.76"
 }
 ],
 "water": "57.1",
 "errored_text": "<p>Заказывайте тексты, фото и видео за <a <span class=\"syntax_noerr\">href</span>=\"<span class=\"syntax_noerr\">https</span>://<span class=\"syntax_noerr\">advego</span>.<span class=\"syntax_noerr\">com</span>\">минимум действий</a> — система сама найдет исполнителей, и вы получите качественный уникальный <span class=\"syntax_err\" title=\"конвент\">контент</span> в кратчайшие сроки:</p>",
 "norma_words": [
 {
 "cnt": 1,
 "word": "видео",
 "tf": "4.76"
 },
 {
 "cnt": 1,
 "word": "действие",
 "tf": "4.76"
 },
 {
 "cnt": 1,
 "word": "заказывать",
 "tf": "4.76"
 },
 {
 "cnt": 1,
 "word": "исполнитель",
 "tf": "4.76"
 },
 {
 "cnt": 1,
 "word": "качественный",
 "tf": "4.76"
 },
 {
 "tf": "4.76",
 "word": "контент",
 "cnt": 1
 },
 {
 "tf": "4.76",
 "word": "краткий",
 "cnt": 1
 },
 {
 "cnt": 1,
 "word": "минимум",
 "tf": "4.76"
 },
 {
 "word": "найти",
 "cnt": 1,
 "tf": "4.76"
 },
 {
 "tf": "4.76",
 "word": "получить",
 "cnt": 1
 },
 {
 "tf": "4.76",
 "word": "система",
 "cnt": 1
 },
 {
 "word": "срок",
 "cnt": 1,
 "tf": "4.76"
 },
 {
 "cnt": 1,
 "word": "текст",
 "tf": "4.76"
 },
 {
 "tf": "4.76",
 "word": "уникальный",
 "cnt": 1
 },
 {
 "word": "фото",
 "cnt": 1,
 "tf": "4.76"
 }
 ],
 "text_len": 155,
 "real_words_cnt": 9,
 "text_len_wo_spaces": 133,
 "toshnota": "1.00",
 "words_cnt": 20,
 "syntax_errs_cnt": 1,
 "text_ok": 1,
 "template_name": "text/text_seo_results_form.html"
 },
 "check_type": "seo",
 "id_text_quality": "150519",
 "id_user": "16830831",
 "id_text_quality_pack": "140399",
 "exicution_date": null,
 "header": "<p>Заказывайте тексты, фото и видео за <a href=\"https://advego.com\">минимум действий</a> — система "
 },
 {
 "create_date": "2025-11-01 15:19:10.176951",
 "result": {
 "fragments": [
 {
 "text": "Заказывайте тексты, фото и видео за минимум действий — система сама найдет исполнителей, и ",
 "num": -1
 },
 {
 "num": "1",
 "text": "вы получите"
 },
 {
 "text": " качественный уникальный контент ",
 "num": -1
 },
 {
 "num": "2",
 "text": "в кратчайшие сроки"
 },
 {
 "text": ":",
 "num": -1
 }
 ],
 "id_currency": "643",
 "need_symbols": 154,
 "phrases": {
 "1": [
 {
 "category": "Общие фразы",
 "sample": "Плохо:\nПри заказе комплексных услуг в компании \"Компромисс\" вы получите скидку 15%.\nХорошо:\nВ компании \"Компромисс\" при заказе комплексных услуг действует скидка 15%.\n",
 "list": [
 [
 27,
 28,
 29
 ]
 ],
 "explanation": "Придает фразе мнимую дружественность. Описывает общими словами что угодно, не несет информационной нагрузки. ",
 "phrase": "вы получите",
 "num": 1,
 "type": "Штамп",
 "dphtype": "Штамп",
 "decision": "Удалить или заменить на формулировку с нейтральной стилистической окраской."
 }
 ],
 "2": [
 {
 "dphtype": "Штамп",
 "decision": "Заменить на формулировку с указанием конкретных фактов и характеристик / фразу с нейтральной стилистической окраской.",
 "list": [
 [
 37,
 38,
 39,
 40,
 41
 ]
 ],
 "explanation": "Придает фразе мнимую весомость. Описывает общими словами что угодно, не несет информационной нагрузки. ",
 "phrase": "в кратчайшие сроки",
 "sample": "Плохо:\nРемонтно-строительная бригада компании \"Перфект\" выполняет работы в кратчайшие сроки.\nХорошо:\nРемонтно-строительная бригада компании \"Перфект\" соблюдает сроки, указанные в договоре.",
 "category": "Общие фразы",
 "num": 2,
 "type": "Штамп"
 }
 ]
 },
 "stat": {
 "text_original": "Заказывайте тексты, фото и видео за минимум действий — система сама найдет исполнителей, и вы получите качественный уникальный контент в кратчайшие сроки:",
 "common_phrases": 2,
 "insignificant_phrases": 0,
 "text_length": 21,
 "phrases_number": 2,
 "symbols": 154,
 "estimation": "73.75"
 },
 "text": [
 "Заказывайте",
 " ",
 "тексты",
 ", ",
 "фото",
 " ",
 "и",
 " ",
 "видео",
 " ",
 "за",
 " ",
 "минимум",
 " ",
 "действий",
 " — ",
 "система",
 " ",
 "сама",
 " ",
 "найдет",
 " ",
 "исполнителей",
 ", ",
 "и",
 " ",
 "вы",
 " ",
 "получите",
 " ",
 "качественный",
 " ",
 "уникальный",
 " ",
 "контент",
 " ",
 "в",
 " ",
 "кратчайшие",
 " ",
 "сроки",
 ":"
 ]
 },
 "state": 2,
 "check_type": "linguist",
 "id_text_quality": "150518",
 "id_user": "16830831",
 "id_text_quality_pack": "140399",
 "exicution_date": null,
 "header": "<p>Заказывайте тексты, фото и видео за <a href=\"https://advego.com\">минимум действий</a> — система "
 }
 ]
 }
 ],
 "page_num": "1"
 },
 "jsonrpc": "2.0",
 "id": 1
}

-----

3. Выгрузка результатов одной проверки

TextQualityPack.get_pack

Параметры:

• token — токен для авторизации;
• id_text_quality_pack — id проверки.

Пример запроса:

{
"jsonrpc": "2.0",
"method": "TextQualityPack.get_pack",
"id": 1,
"params": {
"appid": "",
"token": "TOKEN",
"id_text_quality_pack": "140399"
}
}

Ответ:

Аналогичен по формату ответу в методе TextQualityPack.get_list.

-----

Расшифровка параметров:

estimation - оценка качества текста в баллах (максимум - 100.00).

Градация оценок:

• 90 и выше: отлично;
• 85 - 90: хорошо (текст хорошо читается, но проверьте, не слишком ли он формализован или обобщен);
• 80 - 85: удовлетворительно (в тексте заметно часто встречается канцелярит, общие фразы и штампы);
• ниже 80: неудовлетворительно (текст читается как водянистый, неконкретный)

text_length - общее количество слов в тексте.

symbols - объем текста в символах без пробелов.

phrases_number - общее количество фраз, ухудшающих качество текста.

insignificant_phrases - количество малозначимых фраз.

common_phrases - количество общих фраз.

text - проверяемый текст, разбитый на элементарные единицы: слова, пробелы, знаки препинания. Нумерация элементов используется в дальнейшем для выделения фраз по номерам элементов. Нумерация начинается с 1.

phrases - найденные фразы с подробным комментарием по каждой фразе (немеруются, начиная с 1):

• phrase - фраза,
• num - номер фразы по порядку,
• category - тип фразы (малозначимая или общая),
• type, dphtype - разновидность фразы (неопределеность, менторство и т. д.),
• explanation - объяснение проблемности фразы,
• decision - рекомендации по решению проблемности или улучшению фразы,
• sample - примеры применения в текстах (удачные и неудачные),
• list - список номеров элементов, из которых состоит фраза, в соответствии с нумерацией элементов из параметра text.

fragments - текст, разбитый на фрагменты: последовательный набор из найденных фраз и оставшегося текста:

• text - текстовый фрагмент,
• num - номер найденной фразы по порядку (нумерация начинается с 1). Если значение равно минус 1, фрагмент относится к остальному тексту.

header - название проверки. Если не задано, то берутся первые 100 символов проверяемого текста.

id_result - уникальный id проверки.

date - дата и время проверки (UTC +0).