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

API для парсинга подсказок YouTube:
URL: https://tools.pixelplus.ru/api/podskazkiyoutube

Описание:
Метод позволяет создать задачу для парсинга подсказок YouTube.
Для создания задачи необходимо сформировать запрос и отправить его на URL метода с обязательными GET-параметрами key параметрами необходимыми для запуска задачи. Система поставит задачу в очередь выполнения и вернет идентификатор отчета: report_id. Для получения результата проверки необходимо отправить GET запрос с параметрами key и report_id.

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

1. Обязательные параметры:

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

2. Необязательные параметры:

1. region — регион (RU, UA, BY, KZ);
2. deep — глубина (от 1 до 3, по умолчанию 1);
3. stop_list — стоп-слова через запятую
4. cb_with_space=on — c пробелом и без после фразы;
5. cb_with_cyrillic=on — c перебором кириллического алфавита;
6. cb_with_numbers=on — c перебором цифр;
7. cb_with_english=on — c перебором английского алфавита;

Метод возвращает JSON с массивом:

В случае запроса на обработку:  [{"report_id":"номер запроса"}]
В случае запроса обработки (request - отправленный запрос, response - ответ инструмента): 

1. [{"error":"In progress", "code":50}]
2. {"request": {входные параметры},"response":{"warning_text":текст предупреждения,"count_words":{фраза 1: число слов в фразе1, фраза 2: число слов в фразе2, ...}, "count_phrases":общее число фраз, "excess_requests_flag":флаг срабатывания ограничений, "not_parsed_phrases":фразы для которых не был осуществлен парсинг}}

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

1. {"query":"Not set","code":-50} — если не задан запрос для парсинга;
2. {"request":"Not set","code":-50} — если не задан запрос для парсинга;
3. {"error":"error","code":-4} — если задан неверный report_id;
4. {"error":"In progress","code":50} — если по запросу report_id все еще идет проверка;
5. {"error":"In progress","code":-32,"report_id":номер} — при попытке запустить инструмент, пока не выполнена предыдущая проверка;
6. {"error":"access denided","code":-1} — если не задан ключ доступа;
7. {"error":"access denided","code":-2} — если неверно задан ключ доступа;
8. {"error":"unknown method","code":-3} — если неверно задано название метода;
9. {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
10. {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
11. {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
12. {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
13. {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
14. {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
15. {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
16. {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем;
17. {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
18. {"error":"Processing error":-125} — непредвиденная ошибка;

Пример формирования GET:
GET:
$url = 'http://tools.pixelplus.ru/api/podskazkiyoutube?key=API_KEY&request=пример®ion=RU&deep=1&cb_with_space=on&stop_list=пример1,пример2';