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

`analizzaprosa` Детальный анализ поискового запроса

Собирает по одному запросу и региону Яндекса сводку: геозависимость, частоты Вордстата, слова подсветки и тематики, главные страницы в ТОП-10, бюджет и число объявлений Директа, вхождения в Title и сниппеты. Метод асинхронный: первый запрос возвращает report_id, по нему приходит результат. То же, что инструмент Детальный анализ запроса.

Стоимость: 5 лимитов за запрос
Режим: асинхронный: report_id
Запросов за задачу: 1
Параметры: только в query-строке

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

GET /api/analizzaprosa

Лимиты списываются при постановке задачи.

Параметры query

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

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

Поисковый запрос — один.
lr int обязательный

Регион Яндекса, например 213 — Москва.

Ответ

report_id int

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

GET /api/analizzaprosa

curl -G 'https://tools.pixelplus.ru/api/analizzaprosa' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'query=купить диван' \
  --data-urlencode 'lr=213'

<?php
$url = 'https://tools.pixelplus.ru/api/analizzaprosa?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'query' => 'купить диван',
    'lr' => 213,
]);

$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/analizzaprosa",
    params={
        "key": "ВАШ_КЛЮЧ",
        "query": "купить диван",
        "lr": 213,
    },
    timeout=60,
)
print(response.json())

query обязательный Поисковый запрос — один lr обязательный Регион Яндекса, например 213 — Москва

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

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

{
    "report_id": 2617068
}

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

GET /api/analizzaprosa

Пока задача в работе, приходит {"error":"In progress","code":50}. Опрашивайте раз в 10–30 секунд.

Параметры query

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

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

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

Ответ

Показатели лежат в response. Да/нет-значения — строками Да и Нет.

request object

query и lr из постановки.
response object

Результат анализа.
Вложенные поля
- user_query string
  
  Запрос в нижнем регистре.
- geo string
  
  Геозависимость: Да, Нет или Проверить.
- local_pow string
  
  Степень локализации выдачи, %.
- overall int
  
  Общая частота Вордстата в регионе; -1, если получить не удалось.
- exact int
  
  Точная частота Вордстата; -1, если получить не удалось.
- without_spektr string
  
  Слова из подсветки, кроме слов запроса и СПЕКТРа, через запятую.
- with_spektr string
  
  Слова СПЕКТРа через запятую.
- thematic_words string
  
  Слова, задающие тематику, через запятую.
- top10_main int
  
  Главных страниц в ТОП-10.
- vital_flag string
  
  Есть ли витальный ответ.
- correct string
  
  Нет, если Яндекс исправил или переформулировал запрос.
- found_docs string
  
  Число найденных документов.
- budget_mi int|string
  
  Бюджет по MegaIndex; при ошибке — строка-пояснение.
- ads_yd int
  
  Объявлений в Яндекс Директе.
- exact_title int
  
  Точных вхождений в Title в ТОП-50.
- exact_passages int
  
  Точных вхождений в сниппеты в ТОП-50.
- age_top int
  
  Медианный возраст документов ТОП-10, дней.
- age_top_human string
  
  То же словами.
- intents string
  
  Доли интентов выдачи: коммерция, отзывы, медиа, словари, музыка, путешествия.

GET /api/analizzaprosa

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

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

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

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

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

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

{
    "request": {
        "query": "купить диван",
        "lr": "213"
    },
    "response": {
        "user_query": "купить диван",
        "geo": "Да",
        "local_pow": "60",
        "overall": 412000,
        "exact": 9800,
        "without_spektr": "диваны, мебель",
        "with_spektr": "",
        "thematic_words": "цена, каталог, доставка",
        "top10_main": 2,
        "vital_flag": "Нет",
        "correct": "Да",
        "found_docs": "5000000",
        "budget_mi": 1250000,
        "ads_yd": 8,
        "exact_title": 31,
        "exact_passages": 44,
        "age_top": 2900,
        "age_top_human": "7 лет 11 месяцев",
        "intents": "Коммерциализация: 90% / Отзывы: 10% / Фото и видео: 0% / Словари и определения: 0% / Музыка: 0% / Путешествия: 0%"
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `query` или `lr`; имя параметра — ключ в ответе.
`50`	`In progress`	Задача ещё выполняется.
`-60`	`To many tasks from one user. Try again later.`	У пользователя уже больше 5 незавершённых задач анализа запроса.
`-4`	`Access denied`	`report_id` не существует, принадлежит другому пользователю или другому инструменту.
`-104`	`Processing error`	Задача завершилась с ошибкой. Также `-105` (кончились лимиты), `-106` (отменена), `-107` (дольше 6 часов), `-125` (прочее).
`-68`	`Not enough daily limits`	Не хватает 5 лимитов. Для тарифов с ограничением по периодам — также `-80`, `-81`, `-82`, `-83`; в ответе есть `available` и `need`.
`-1`	`Access denied`	Не передан `key`. HTTP-код 404.
`-2`	`Access denied`	Ключ не найден. HTTP-код 403.

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

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

Нужен список запросов, а не один? Геозависимость пачкой отдаёт geo, частоты — wordstatapi, комплексный анализ списка запросов — complex_queries_analyser.

analizzaprosa Детальный анализ поискового запроса

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

Параметры query

Ответ

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

Параметры query

Ответ

Ошибки

`analizzaprosa` Детальный анализ поискового запроса