Документация на метод "complex_queries_analyser"

API для комплексного анализа запросов:
URL: https://tools.pixelplus.ru/api/complex_queries_analyser

Принимает параметры:
GET:

1. key — ключ доступа к API;
2. report_id — номер отчета с анализом;

POST:

1. requests — массив запросов для проверки;
2. deep — глубина анализа выдачи;
3. search_system — поисковая система для анализа;
4. lr — регион по Яндексу;
5. geo — геозависимость и локализация;
6. intent — оценка интента запроса;
7. comm — коммерциализация запроса;
8. site-type — определение типов сайтов в выдаче;
9. gruppirovka —  группировка, частоты, позиции и количество главных;
10. gruppirovka_method — метод группировки;
11. gruppirovka_user_grouping_pow — степень группировки;
12. gruppirovka_home_pages — подсчет количества главных страниц в выдаче;
13. wordstat-advanced — собрать частоты запросов;
14. gruppirovka_site_pos — получить позиции сайта;
15. gruppirovka_rel_url — определить релевантные URL на сайте;
16. exceptions_words_filter — указать список стоп-слов;
17. exceptions_words — массив слов исключений;

ДОПУСТИМЫЕ ЗНАЧАНИЯ ПАРАМЕТРОВ:

1. requests — массив ключевых слов до 2500 штук;
2. deep — целое число, может принимать значения 10, 25 и 50, по умолчанию 25;
3. search_system — 1 или 2, по умлочанию 1 (1 — Яндекс, 2 — Google);
4. lr — код региона в Яндексе из списка, скажем, Москва — 213 (можно опустить, по умолчанию стоит регион 213);
5. geo — 1 или null (можно опустить, по умолчанию стоит null);
6. intent — 1 или null (можно опустить, по умолчанию стоит null);
7. site-type — 1 или null (можно опустить, по умолчанию стоит null);
8. gruppirovka —  1 или null (можно опустить, по умолчанию стоит null);
9. gruppirovka_method — целое число от 0 до 3. Поддерживаются методы pixeltools — 3, hard — 2, middle — 1, soft — 0, подробней (можно опустить, по умолчанию выбран метод pixeltools — 3);
10. gruppirovka_user_grouping_pow — число от 1 до 10 (можно опустить, по умолчанию выбрано значение 3);
11. gruppirovka_home_pages — 1 или null (можно опустить, по умолчанию стоит null);
12. gruppirovka_ws_queries — 1 или null (можно опустить, по умолчанию стоит null);
13. gruppirovka_site_pos — 1 или null (можно опустить, по умолчанию стоит null);
14. gruppirovka_rel_url — доменное имя сайта или null (можно опустить, по умолчанию стоит null)
15. exceptions_words_filter — 1 или null (можно опустить, по умолчанию стоит null);
16. 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 — ориентировочная стоимость инструмента, может незначительно отличаться от фактической в меньшую сторону.

В случае неудачи:

1. {"error":"Requests empty or is not an array","code":-50} — не заданы или неверно заданы запросы для проверки;
2. {"error":"To many tasks from one user. Try again later.","code":-60} — превышен лимит одновременно поставленных задач для пользователя;
3. {"error":"No requests data","code":-51} — не переданы запросы в POST;
4. {"error":"You do not have enough limits for the processing of all requests","code":-69} - не хватает лимитов для обработки всех запросов;
5. {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
6. {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
7. {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем
8. {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
9. {"error":"Processing error":-125} — не предвиденная ошибка;
10. {"error":"Access denided","code":-1} — не задан ключ доступа;
11. {"error":"Access denided","code":-2} — неверно задан ключ доступа;
12. {"error":"Unknown method","code":-3} — неверно задано название метода;