Поиск

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

API для инструмента «Анализ количества рекламных объявлений в выдаче Яндекса»:
url: https://tools.pixelplus.ru/api/analizreklamyyandex

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


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

  1. key — ключ доступа к API (обязательный);
  2. report_id — Идентификатор отчета;

POST:

  1. queries — список запросов (обязательный);
  2. lr — регион по Яндексу (обязательный);

Максимальное количество запросов — 100:

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

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

{
  "request": {
    "queries": [
      "запрос"
    ],
    "lr": "Регион по Яндексу",
    "csv": false
  },
  "response": {
    "запрос": {
      "countPromotion": {
        "top": Кол-во  рекламных объявлений над поиком или "Нет в выдаче",
        "low": Кол-во  рекламных объявлений под поиком или "Нет в выдаче",
        "direct": Кол-во Яндекс директа или "Нет в выдаче",
        "all": Кол-во органики в выдаче
      },
      "position": {
        "Яндекс.Маркет среди выдачи (место)": "Позиция или Нет в выдаче",
        "Яндекс.Видео (место)": "Позиция или Нет в выдаче",
        "Яндекс.Картинки (место)": "Позиция или Нет в выдаче",
        "Яндекс.Путешествия (место)": "Позиция или Нет в выдаче",
        "Яндекс.Коллекции (место)": "Позиция или Нет в выдаче",
        "Яндекс.Авиабилеты (место)": "Позиция или Нет в выдаче",
        "Яндекс.Новости (место)": "Позиция или Нет в выдаче",
        "Яндекс.Погода (место)": "Позиция или Нет в выдаче",
        "Яндекс.Карты (место)": "Позиция или Нет в выдаче",
        "Яндекс.Почта (место)": "Позиция или Нет в выдаче",
        "Яндекс.Музыка (место)": "Позиция или Нет в выдаче",
        "Яндекс.Афиша (место)": "Позиция или Нет в выдаче",
        "taxi.yandex.ru (место)": "Позиция или Нет в выдаче",
        "Яндекс.Такси (место)": "Позиция или Нет в выдаче",
        "Яндекс.Деньги (место)": "Позиция или Нет в выдаче",
        "Яндекс.Диск (место)": "Позиция или Нет в выдаче",
        "Яндекс.Недвижимость (место)": "Позиция или Нет в выдаче",
        "realty.yandex.ru (место)": "Позиция или Нет в выдаче",
        "Яндекс.Работа (место)": "Позиция или Нет в выдаче",
        "Яндекс.Таланты (место)": "Позиция или Нет в выдаче",
        "Яндекс.Толока (место)": "Позиция или Нет в выдаче",
        "Авто.ру (место)": "Позиция или Нет в выдаче",
        "Яндекс.Телефония (место)": "Позиция или Нет в выдаче",
        "Яндекс.Доставка (место)": "Позиция или Нет в выдаче",
        "Яндекс.Еда (место)": "Позиция или Нет в выдаче"
      },
      "koldunshiki": "Список Колдунщиков через запятую"
    }
  }
}

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

  1. {"error":"In progress","code":50} — задание с таким идентификатором еще не выполнено;
  2. {"error":"To much requests","code":"-67"} — задано слишком много запросов; 
  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":"access denided","code":-1} — если не задан ключ доступа;
  9. {"error":"access denided","code":-2} — если неверно задан ключ доступа;
  10. {"error":"unknown method","code":-3} — если неверно задано название метода;

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

{
  "request": {
    "queries": [
      "пиксель тулс",
      "seo",
      "разработка сайтов"
    ],
    "lr": "213",
    "csv": false
  },
  "response": {
    "пиксель тулс": {
      "countPromotion": {
        "top": "Нет в выдаче",
        "low": "Нет в выдаче",
        "direct": "Нет в выдаче",
        "all": 10
      },
      "position": {
        "Яндекс.Маркет среди выдачи (место)": "Нет в выдаче",
        "Яндекс.Видео (место)": "Нет в выдаче",
        "Яндекс.Картинки (место)": "Нет в выдаче",
        "Яндекс.Путешествия (место)": "Нет в выдаче",
        "Яндекс.Коллекции (место)": "Нет в выдаче",
        "Яндекс.Авиабилеты (место)": "Нет в выдаче",
        "Яндекс.Новости (место)": "Нет в выдаче",
        "Яндекс.Погода (место)": "Нет в выдаче",
        "Яндекс.Карты (место)": 5,
        "Яндекс.Почта (место)": "Нет в выдаче",
        "Яндекс.Музыка (место)": "Нет в выдаче",
        "Яндекс.Афиша (место)": "Нет в выдаче",
        "taxi.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Такси (место)": "Нет в выдаче",
        "Яндекс.Деньги (место)": "Нет в выдаче",
        "Яндекс.Диск (место)": "Нет в выдаче",
        "Яндекс.Недвижимость (место)": "Нет в выдаче",
        "realty.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Работа (место)": "Нет в выдаче",
        "Яндекс.Таланты (место)": "Нет в выдаче",
        "Яндекс.Толока (место)": "Нет в выдаче",
        "Авто.ру (место)": "Нет в выдаче",
        "Яндекс.Телефония (место)": "Нет в выдаче",
        "Яндекс.Доставка (место)": "Нет в выдаче",
        "Яндекс.Еда (место)": "Нет в выдаче"
      },
      "koldunshiki": "Доп. информация справа"
    },
    "seo": {
      "countPromotion": {
        "top": 1,
        "low": 5,
        "direct": "Нет в выдаче",
        "all": 10
      },
      "position": {
        "Яндекс.Маркет среди выдачи (место)": "Нет в выдаче",
        "Яндекс.Видео (место)": "Нет в выдаче",
        "Яндекс.Картинки (место)": "Нет в выдаче",
        "Яндекс.Путешествия (место)": "Нет в выдаче",
        "Яндекс.Коллекции (место)": "Нет в выдаче",
        "Яндекс.Авиабилеты (место)": "Нет в выдаче",
        "Яндекс.Новости (место)": "Нет в выдаче",
        "Яндекс.Погода (место)": "Нет в выдаче",
        "Яндекс.Карты (место)": "Нет в выдаче",
        "Яндекс.Почта (место)": "Нет в выдаче",
        "Яндекс.Музыка (место)": "Нет в выдаче",
        "Яндекс.Афиша (место)": "Нет в выдаче",
        "taxi.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Такси (место)": "Нет в выдаче",
        "Яндекс.Деньги (место)": "Нет в выдаче",
        "Яндекс.Диск (место)": "Нет в выдаче",
        "Яндекс.Недвижимость (место)": "Нет в выдаче",
        "realty.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Работа (место)": "Нет в выдаче",
        "Яндекс.Таланты (место)": "Нет в выдаче",
        "Яндекс.Толока (место)": "Нет в выдаче",
        "Авто.ру (место)": "Нет в выдаче",
        "Яндекс.Телефония (место)": "Нет в выдаче",
        "Яндекс.Доставка (место)": "Нет в выдаче",
        "Яндекс.Еда (место)": "Нет в выдаче"
      },
      "koldunshiki": "МКБ, Чаты с организациями справа"
    },
    "разработка сайтов": {
      "countPromotion": {
        "top": 4,
        "low": 4,
        "direct": 4,
        "all": 10
      },
      "position": {
        "Яндекс.Маркет среди выдачи (место)": "Нет в выдаче",
        "Яндекс.Видео (место)": "Нет в выдаче",
        "Яндекс.Картинки (место)": "Нет в выдаче",
        "Яндекс.Путешествия (место)": "Нет в выдаче",
        "Яндекс.Коллекции (место)": "Нет в выдаче",
        "Яндекс.Авиабилеты (место)": "Нет в выдаче",
        "Яндекс.Новости (место)": "Нет в выдаче",
        "Яндекс.Погода (место)": "Нет в выдаче",
        "Яндекс.Карты (место)": "Нет в выдаче",
        "Яндекс.Почта (место)": "Нет в выдаче",
        "Яндекс.Музыка (место)": "Нет в выдаче",
        "Яндекс.Афиша (место)": "Нет в выдаче",
        "taxi.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Такси (место)": "Нет в выдаче",
        "Яндекс.Деньги (место)": "Нет в выдаче",
        "Яндекс.Диск (место)": "Нет в выдаче",
        "Яндекс.Недвижимость (место)": "Нет в выдаче",
        "realty.yandex.ru (место)": "Нет в выдаче",
        "Яндекс.Работа (место)": "Нет в выдаче",
        "Яндекс.Таланты (место)": "Нет в выдаче",
        "Яндекс.Толока (место)": "Нет в выдаче",
        "Авто.ру (место)": "Нет в выдаче",
        "Яндекс.Телефония (место)": "Нет в выдаче",
        "Яндекс.Доставка (место)": "Нет в выдаче",
        "Яндекс.Еда (место)": "Нет в выдаче"
      },
      "koldunshiki": "МКБ, Чаты с организациями справа"
    }
  }
}