Поиск

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

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

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

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

  1. key — ключ доступа к API;

POST:

  1. requests — массив запросов для проверки;
  2. lr — регион по Яндексу;
  3. time — возвращать время обработки запросов, по умолчанию нет.

Возвращает JSON:

В случае успеха:

{"data":{"мебель":{"com":88,"rev":0,"media":2,"lex":0,"music":0,"trav":2},"офисная мебель купить":{"com":94,"rev":2,"media":2,"lex":0,"music":0,"trav":2}},"tools_time":0.36180400848389, "time":response_time,"cost":26}

Где:

  • 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":"Access denided","code":-1} — не задан ключ доступа;
  10. {"error":"Access denided","code":-2} — неверно задан ключ доступа;
  11. {"error":"Unknown method","code":-3} — неверно задано название метода;

Пример получения данных с данного API:

$.post("https://tools.pixelplus.ru/api/intent?key=ВАШ_API_КЛЮЧ", {
    requests: ['мебель', 'офисная мебель купить'],
    lr: 213, // Опционально
    time: true // Опционально
}, function(data) {
    alert(JSON.stringify(data));
});