Поиск

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

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

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

Обязательные параметры выделены жирным шрифтом.
GET:

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

POST:

  1. requests — массив запросов для проверки;
  2. lr — регион по Яндексу (по умолчанию 213);
  3. search_system — поисковая система, принимает yandex или google (по умолчанию yandex);
  4. 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 — ориентировочная стоимость инструмента, может незначительно отличаться от фактической в меньшую сторону.

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

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