Поиск

Документация на метод "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} — недостаточно годовых лимитов;

Пример формирования 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';