Документация на метод "complex_queries_analyser"
API для комплексного анализа запросов:
URL: https://tools.pixelplus.ru/api/complex_queries_analyser
Принимает параметры:
GET:
- key — ключ доступа к API;
- report_id — номер отчета с анализом;
POST:
- requests — массив запросов для проверки;
- deep — глубина анализа выдачи;
- search_system — поисковая система для анализа;
- lr — регион по Яндексу;
- geo — геозависимость и локализация;
- intent — оценка интента запроса;
- comm — коммерциализация запроса;
- site-type — определение типов сайтов в выдаче;
- gruppirovka — группировка, частоты, позиции и количество главных;
- gruppirovka_method — метод группировки;
- gruppirovka_user_grouping_pow — степень группировки;
- gruppirovka_home_pages — подсчет количества главных страниц в выдаче;
- wordstat-advanced — собрать частоты запросов;
- gruppirovka_site_pos — получить позиции сайта;
- gruppirovka_rel_url — определить релевантные URL на сайте;
- exceptions_words_filter — указать список стоп-слов;
- exceptions_words — массив слов исключений;
ДОПУСТИМЫЕ ЗНАЧАНИЯ ПАРАМЕТРОВ:
- requests — массив ключевых слов до 2500 штук;
- deep — целое число, может принимать значения 10, 25 и 50, по умолчанию 25;
- search_system — 1 или 2, по умлочанию 1 (1 — Яндекс, 2 — Google);
- lr — код региона в Яндексе из списка, скажем, Москва — 213 (можно опустить, по умолчанию стоит регион 213);
- geo — 1 или null (можно опустить, по умолчанию стоит null);
- intent — 1 или null (можно опустить, по умолчанию стоит null);
- site-type — 1 или null (можно опустить, по умолчанию стоит null);
- gruppirovka — 1 или null (можно опустить, по умолчанию стоит null);
- gruppirovka_method — целое число от 0 до 3. Поддерживаются методы pixeltools — 3, hard — 2, middle — 1, soft — 0, подробней (можно опустить, по умолчанию выбран метод pixeltools — 3);
- gruppirovka_user_grouping_pow — число от 1 до 10 (можно опустить, по умолчанию выбрано значение 3);
- gruppirovka_home_pages — 1 или null (можно опустить, по умолчанию стоит null);
- gruppirovka_ws_queries — 1 или null (можно опустить, по умолчанию стоит null);
- gruppirovka_site_pos — 1 или null (можно опустить, по умолчанию стоит null);
- gruppirovka_rel_url — доменное имя сайта или null (можно опустить, по умолчанию стоит null)
- exceptions_words_filter — 1 или null (можно опустить, по умолчанию стоит null);
- exceptions_words — массив слов до 1000 штук;
Для запуска инструмента должна быть выбрана минимум одна из доступных проверок geo, intent, site-type или gruppirovka.
Возвращает JSON:
В случае запроса на обработку: {"report_id":"номер запроса"}
В случае запроса обработки (request - отправленный запрос, response - ответ инструмента, time - время ответа инструмента, cost - расчетная стоимость в лимитах, может незначительно отличаться от фактической)
Где:
-
requests — данные запроса для которого выполнена задача.
-
response — суммарный ответ инструмента.
-
geo — определение геозависимости по запросам
-
local_pow — степень геозависимости по запросам
-
thematic_words — тематические слова для запроса (если запрашивалась коммерциализация)
-
com — процент коммерческих результатов в ТОП-50 выдачи (если запрашивалась коммерциализация).
-
rev — процент результатов, которые содержат отзывы (если запрашивалась коммерциализация).
-
media — процент результатов фото и видео направленности (медиа) (если запрашивалась коммерциализация).
-
lex — процент словарных документов (словари) (если запрашивалась коммерциализация).
-
music — процент музыкальных результатов (скачать, слушать, mp3 и так далее) (если запрашивалась коммерциализация).
-
trav — процент результатов по тематике путешествия / отдых (если запрашивалась коммерциализация).
-
classified — процент разных типов сайтов в выдаче.
-
ws_exact — точная частота зароса
-
ws_overall — общая частота зароса
-
time — время ответа инструмента.
-
cost — ориентировочная стоимость инструмента, может незначительно отличаться от фактической в меньшую сторону.
В случае неудачи:
- {"error":"Requests empty or is not an array","code":-50} — не заданы или неверно заданы запросы для проверки;
- {"error":"To many tasks from one user. Try again later.","code":-60} — превышен лимит одновременно поставленных задач для пользователя;
- {"error":"No requests data","code":-51} — не переданы запросы в POST;
- {"error":"You do not have enough limits for the processing of all requests","code":-69} - не хватает лимитов для обработки всех запросов;
- {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
- {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
- {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем
- {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
- {"error":"Processing error":-125} — не предвиденная ошибка;
- {"error":"Access denided","code":-1} — не задан ключ доступа;
- {"error":"Access denided","code":-2} — неверно задан ключ доступа;
- {"error":"Unknown method","code":-3} — неверно задано название метода;