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

`intent` Коммерциализация и интент запросов по выдаче

Для каждого запроса из списка смотрит ТОП-10, 25 или 50 Яндекса или Google и считает, какая доля результатов коммерческая, с отзывами, медиа, словарная, музыкальная и туристическая, плюс отдаёт тематические слова выдачи. Метод асинхронный: постановка отдаёт report_id. В интерфейсе — Интент и коммерциализация. Геозависимость этот метод не определяет — она есть в комплексном анализе запросов и в geo.

Режим: асинхронный: report_id
Стоимость: 1 лимит за запрос
Одновременно: до 6 задач на пользователя

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

POST /api/intent

Ключ — в query-строке, запросы и настройки — в теле формы. Лимиты списываются сразу при постановке.

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

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

Ключ API из настроек аккаунта.
requests array обязательный

Запросы: массив requests[] или одна строка с запросами через \r\n. Пустые и повторяющиеся строки отбрасываются только во втором варианте.
lr int

Регион Яндекса, например 213 — Москва. Для Google переводится в соответствующий регион.

По умолчанию 213
search_system string

Поисковая система. Любое другое значение — Яндекс.

yandex
Яндекс

google
Google

По умолчанию yandex
deep int

Глубина анализа выдачи. Округляется вверх до ближайшей из трёх: до 10 включительно — ТОП-10, до 25 — ТОП-25, больше — ТОП-50.

10
ТОП-10

25
ТОП-25

50
ТОП-50

По умолчанию 10

Ответ

report_id int

Номер задачи.

POST /api/intent

curl -X POST 'https://tools.pixelplus.ru/api/intent?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'requests[]=купить велосипед' \
  --data-urlencode 'requests[]=как выбрать велосипед' \
  --data-urlencode 'lr=213' \
  --data-urlencode 'search_system=yandex' \
  --data-urlencode 'deep=50'

<?php
$url = 'https://tools.pixelplus.ru/api/intent?' . 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([
        'requests' => [
            'купить велосипед',
            'как выбрать велосипед',
        ],
        'lr' => 213,
        'search_system' => 'yandex',
        'deep' => 50,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/intent",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data=[
        ("requests[]", "купить велосипед"),
        ("requests[]", "как выбрать велосипед"),
        ("lr", 213),
        ("search_system", "yandex"),
        ("deep", 50),
    ],
    timeout=60,
)
print(response.json())

requests обязательный Запросы: массив requests[] или одна строка с запросами через \r\n · по одному на строку lr Регион Яндекса, например 213 — Москва search_system Поисковая система deep Глубина анализа выдачи

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

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

{
    "report_id": 18734550
}

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

GET /api/intent

Пока задача выполняется, приходит {"error":"In progress","code":50}.

Параметры query

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

Ключ API из настроек аккаунта.
report_id int обязательный

Номер задачи из ответа на постановку.

Ответ

request object

Параметры задачи: requests, lr, ss, deep (top10/top25/top50).
response.data object

Результат по каждому запросу (ключ — запрос). Все доли — проценты от глубины анализа.
Вложенные поля
- com number
  
  Коммерческие результаты: маркеры вроде «купить», «цена» в заголовках и сниппетах.
- rev number
  
  Отзывы.
- media number
  
  Фото и видео.
- lex number
  
  Словари и определения.
- music number
  
  Музыка: слушать, скачать, mp3.
- trav number
  
  Путешествия и отдых.
- thematic_words array
  
  Самые частые тематические слова выдачи (леммы).
response.time float

Время расчёта в секундах.
response.system string

yandex или google.
time string

Время ответа инструмента.
cost int

Стоимость в лимитах.

GET /api/intent

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

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

$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/intent",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18734550,
    },
    timeout=60,
)
print(response.json())

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

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

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

{
    "request": {
        "requests": [
            "купить велосипед",
            "как выбрать велосипед"
        ],
        "lr": "213",
        "ss": "yandex",
        "deep": "top50"
    },
    "response": {
        "data": {
            "купить велосипед": {
                "thematic_words": [
                    "велосипед",
                    "купить",
                    "цена",
                    "горный",
                    "доставка"
                ],
                "com": 92,
                "rev": 4,
                "media": 6,
                "lex": 0,
                "music": 0,
                "trav": 0
            },
            "как выбрать велосипед": {
                "thematic_words": [
                    "велосипед",
                    "выбрать",
                    "рост",
                    "рама",
                    "совет"
                ],
                "com": 38,
                "rev": 10,
                "media": 18,
                "lex": 2,
                "music": 0,
                "trav": 0
            }
        },
        "time": 1.77,
        "system": "yandex"
    },
    "time": "12",
    "cost": 2
}

Ошибки

Код	Сообщение	Когда
`-50`	`Requests empty or is not an array`	Не переданы запросы.
`-51`	`No requests data`	Задача ставится не POST-запросом.
`-60`	`To many tasks from one user. Try again later.`	У пользователя уже больше 5 незавершённых задач этого инструмента.
`-68, -80…-83`	`Not enough … limits`	Лимитов меньше, чем запросов в списке; в ответе есть `available` и `need`.
`-4`	`Access denied`	`report_id` не найден или чужой.
`50`	`In progress`	Задача ещё выполняется.
`-104…-107, -125`	`Processing error / Limits run out / …`	Задача завершилась ошибкой, закончились лимиты, отменена или шла дольше 6 часов.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

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

{
    "error": "Requests empty or is not an array",
    "code": -50
}

Как читать результат

Доли не складываются в 100%: один результат может быть одновременно коммерческим и с отзывами. Ориентир для отбора запросов: для коммерческих страниц — коммерциализация от 35%, для информационных — до 60%.

Чем отличается от комплексного анализа. intent отвечает только на вопрос «какая выдача по запросу». complex_queries_analyser запускает набор проверок по списку запросов — геозависимость, витальные ответы, коммерциализацию, кластеризацию, частоты, позиции — и сводит их в одну таблицу.

intent Коммерциализация и интент запросов по выдаче

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

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

Ответ

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

Параметры query

Ответ

Ошибки

Как читать результат

`intent` Коммерциализация и интент запросов по выдаче