Документация на метод "intent"
API для проверки геозависимости и локализации запросов:
URL: https://tools.pixelplus.ru/api/intent
Принимает параметры:
Обязательные параметры выделены жирным шрифтом.
GET:
- key — ключ доступа к API;
- report_id - номер отчета с интентом;
POST:
- requests — массив запросов для проверки;
- lr — регион по Яндексу (по умолчанию 213);
- search_system — поисковая система, принимает yandex или google (по умолчанию yandex);
- deep - глубина анализа выдачи, прнимает целое число от 1 до 50 (по умолчанию 50)
Возвращает JSON:
В случае запроса на обработку: {"report_id":"номер запроса"}
В случае запроса обработки (request - отправленный запрос, response - ответ инструмента, time - время ответа инструмента, cost - расчетная стоимость в лимитах, может незначительно отличаться от фактической):
В случае успеха:
{
"request": {
"requests": [
"купить хомячка",
"купить попугая"
],
"lr": "100",
"ss": "yandex",
"deep": 10
},
"response": {
"data": {
"запрос": {
"thematic_words": [
"тематическое слово 1",
"тематическое слово 2",
"тематическое слово 3",
"тематическое слово 4",
"тематическое слово 5"
],
"com": 92,
"rev": 0,
"media": 16,
"lex": 0,
"music": 0,
"trav": 2
}
},
"time": 1.7707540988922,
"system": "yandex"
},
"time": "1565090214",
"cost": 1
}
Где:
-
com — процент коммерческих результатов в ТОП-50 выдачи.
-
rev — процент результатов, которые содержат отзывы.
-
media — процент результатов фото и видео направленности (медиа).
-
lex — процент словарных документов (словари).
-
music — процент музыкальных результатов (скачать, слушать, mp3 и так далее).
-
trav — процент результатов по тематике путешествия / отдых.
-
time — время ответа инструмента.
-
tools_time — время работы инструмента.
-
cost — ориентировочная стоимость инструмента, может незначительно отличаться от фактической в меньшую сторону.
В случае неудачи:
- {"error":"Requests empty or is not an array","code":-50} — не заданы или неверно заданы запросы для проверки;
- {"error":"No requests data","code":-51} — не переданы запросы в POST;
- {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
- {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
- {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
- {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
- {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
- {"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} — неверно задано название метода;