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

`textanalyser` SEO-анализ текста

Разбирает текст как SEO-специалист: считает слова и символы, частоту слов и словосочетаний, вхождения и плотность заданных ключевых фраз, заспамленность, соответствие закону Ципфа, долю стоп-слов и частей речи. По желанию проверяет уникальность и орфографию. Метод асинхронный: постановка возвращает report_id. То же в интерфейсе — текстовый анализатор.

Режим: асинхронный: report_id
Стоимость: 10 лимитов; с проверкой уникальности — +50 за каждые начатые 1000 символов
Длина текста: анализируются первые 25 000 символов

Постановка задачи

POST /api/textanalyser

Текст и ключевые фразы передаются в теле формы, ключ — в query.

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

text string обязательный

Текст для анализа. Длиннее 25 000 символов — обрезается.
requests string

Ключевые фразы, вхождения которых нужно посчитать, — по фразе на строку (или массив requests[]). Из фразы-элемента массива берутся первые 10 слов.
text_unique int

Проверить уникальность. Включается самим наличием параметра — любое значение, даже 0; если проверка не нужна, не передавайте его.
text_errors int

Проверить орфографию. Как и text_unique, включается наличием параметра.

Ответ

report_id int

ID задачи для получения результата.

POST /api/textanalyser

curl -X POST 'https://tools.pixelplus.ru/api/textanalyser?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'text=Пиксель Тулс — SEO-платформа: инструменты для SEO и AI SEO в одном сервисе.' \
  --data-urlencode 'requests=пиксель тулс
seo платформа' \
  --data-urlencode 'text_errors=1'

<?php
$url = 'https://tools.pixelplus.ru/api/textanalyser?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'text' => 'Пиксель Тулс — SEO-платформа: инструменты для SEO и AI SEO в одном сервисе.',
        'requests' => 'пиксель тулс
seo платформа',
        'text_errors' => 1,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/textanalyser",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "text": "Пиксель Тулс — SEO-платформа: инструменты для SEO и AI SEO в одном сервисе.",
        "requests": "пиксель тулс\nseo платформа",
        "text_errors": 1,
    },
    timeout=60,
)
print(response.json())

text обязательный Текст для анализа requests Ключевые фразы, вхождения которых нужно посчитать, — по фразе на строку (или массив requests[]) text_errors Проверить орфографию

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "report_id": 2617071
}

Получение результата

GET /api/textanalyser

Пока задача выполняется, приходит список с одним элементом [{"type": "in_progress", "code": 50, "message": "In progress"}], иногда с progress и time.

Параметры query

report_id int обязательный

ID задачи из ответа на постановку.

Ответ

status, msg string

success и completed.
time string

Время готовности, Unix timestamp.
cost int

Стоимость задачи в лимитах.
request object

Параметры задачи: text, requests, text_unique, text_errors.
response.count_words int

Слов в тексте.
response.count_symbols_with_spaces, count_symbols_without_spaces int

Символов с пробелами и без.
response.words_frequency object

Слово (лемма) → число употреблений.
response.find_phrases object

По каждой фразе из requests: found, count — точные вхождения, morph — морфологические, density — плотность, %, sub_words — по отдельным словам.
response.words_spam float

Заспамленность, %.
response.segments object

words_1 — слова, words_n — словосочетания, stopwords_density — стоп-слова: частота и плотность, по убыванию частоты в двух колонках.
response.zipf float

Соответствие закону Ципфа, 0–100.
response.zipf_words object

По словам: ожидаемая (zipf) и фактическая (current) частота, совпадение в %, сколько добавить или убрать (recommend).
response.zipf_chart_data string

JSON для графика Ципфа по 20 самым частым словам.
response.compressed_percent string

Степень сжатия текста, % — косвенный признак повторов.
response.stopwords_percent float

Доля стоп-слов, %.
response.average_words_length, average_sentences_length, variance_sentences_length float

Средняя длина слова, предложения и разброс длины предложений.
response.speech_parts object

Часть речи → доля, %.
response.unique object

С text_unique: result.unique_value — уникальность, %, result.top10Urls — источники совпадений, raw_result — полный ответ проверки (с водностью, академической тошнотой, индексами читаемости).
response.text_errors object

С text_errors: type — слово → тип ошибки, true_spell — слово → вариант исправления.

GET /api/textanalyser

curl -G 'https://tools.pixelplus.ru/api/textanalyser' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=2617071'

<?php
$url = 'https://tools.pixelplus.ru/api/textanalyser?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 2617071,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/textanalyser",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 2617071,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "status": "success",
    "msg": "completed",
    "time": "1778052575",
    "cost": 10,
    "request": {
        "text": "Пиксель Тулс — SEO-платформа…",
        "requests": "пиксель тулс\nseo платформа",
        "text_errors": "1"
    },
    "response": {
        "count_words": 12,
        "count_symbols_with_spaces": 78,
        "count_symbols_without_spaces": 67,
        "words_frequency": {
            "seo": 2,
            "пиксель": 1,
            "тулс": 1
        },
        "find_phrases": {
            "пиксель тулс": {
                "found": true,
                "count": 1,
                "morph": 0,
                "density": 8.33
            }
        },
        "words_spam": 33,
        "zipf": 91.18,
        "stopwords_percent": 16.67,
        "speech_parts": {
            "существительное": 50,
            "иностранное": 25,
            "предлог": 25
        },
        "text_errors": {
            "type": {
                "тулс": "Слова нет в словаре."
            },
            "true_spell": {
                "тулс": "тулы"
            }
        }
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `text`. Ответ — объект `{"text": "Not set", "code": "-50"}`.
`-51`	`No requests data.`	Задача поставлена не методом POST. Ответ — список `[{"type": "request", "code": -51, "message": …}]`.
`-60`	`Too many tasks from one user. Try again later.`	Идут больше 5 задач этого метода.
`-68, -80…-83`	`Not enough … limits`	Не хватает лимитов на задачу; приходит списком из одного элемента с `available` и `need`.
`50`	`In progress`	Задача ещё выполняется (`type: in_progress`).
`-4`	`Access denied`	`report_id` чужой или от другого инструмента (`type: processing_error`).
`-104…-107, -125`	`Processing error / Limits run out / …`	Задача завершилась ошибкой — см. асинхронные задачи.
`-1, -2`	`Access denied`	Ключ не передан (HTTP 404) или не найден (HTTP 403).

Ответ с ошибкой

{
    "text": "Not set",
    "code": "-50"
}

Формат ошибок

Ошибки этого метода приходят в двух видах: ошибки параметров — объектом с полем-виновником и code, ошибки выполнения и статус «в работе» — списком объектов {type, code, message}. Проверяйте оба варианта.

Что не проверяет

Метод не определяет геозависимость запросов — так он был ошибочно описан раньше. Геозависимость и локализацию проверяет geo.

textanalyser SEO-анализ текста

Постановка задачи

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

Ответ

Получение результата

Параметры query

Ответ

Ошибки

Формат ошибок

Что не проверяет

`textanalyser` SEO-анализ текста