Поиск

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

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

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


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

  1. key — ключ доступа к API;
  2. query — запрос для проверки;
  3. lr — регион по Яндексу;

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

В случае запроса на обработку:  [{"report_id":"номер запроса"}]
Максимальное число одновременно запущеных задач для 1 пользователя: 5
В случае запроса обработки (request — отправленный запрос, response — ответ инструмента): 
 [{"query":"запрос для которого осуществляется проверка","параметр 1":"значение 1","параметр  2":"значение  2", ...]

Названия выходных параметров:

  • geo — геозависимость

  • local_pow — локализация

  • without_spektr — слова из подсветки (без СПЕКТРа) 

  • with_spektr — слова СПЕКТРа 

  • thematic_words — слова, задающие тематику

  • overall — общая частота по WordStat

  • exact — точная частота по WordStat

  • top10_main — число главных страниц в ТОП-10 

  • vital_flag — наличие витального ответа по запросу 

  • found_docs — число найденных по запросу результатов 

  • budget_mi — бюджет по MegaIndex 

  • ads_yd — объявлений в Яндекс.Директ

  • exact_title — точных вхождений в Title в ТОП-50

  • exact_passages — точных вхождений в сниппеты в ТОП-50

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

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