Поиск

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

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

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

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

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

POST:

  1. requests — массив запросов для проверки;

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

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

{"time":response_time,"cost":base_cost,"data":{"мебель":{"geo":"Да","loc":84,"com":88},"офисная мебель купить":{"geo":"Да","loc":86,"com":94}}}

Где:

  • geo — геозависимость / независимость запроса.

  • loc — процент результатов в ТОП-50, которые имеют региональную направленность (локализованы).

  • com — процент коммерческих результатов в выдаче.

  • time — время ответа инструмента.

  • cost — ориентировочная стоимость инструмента, может незначительно отличаться от фактической в меньшую сторону.

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

  1. {"error":"Requests empty or is not an array","code":-50} — не заданы или неверно заданы запросы для проверки;
  2. {"error":"To many tasks from one user. Try again later.","code":-60} — превышен лимит одновременно поставленных задач для пользователя;
  3. {"error":"No requests data","code":-51} — не переданы запросы в POST;
  4. {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
  5. {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
  6. {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
  7. {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
  8. {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
  9. {"error":"You do not have enough limits for the processing of all requests","code":-69} - не хватает лимитов для обработки всех запросов;
  10. {"error":"Access denided","code":-1} — не задан ключ доступа;
  11. {"error":"Access denided","code":-2} — неверно задан ключ доступа;
  12. {"error":"Unknown method","code":-3} — неверно задано название метода;

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

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