Инструменты · key

`analizreklamyyandex` Реклама, сервисы Яндекса и колдунщики в выдаче по запросам

По каждому запросу считает рекламные объявления над, под и внутри органической выдачи Яндекса, находит места сервисов Яндекса (Маркет, Карты, Картинки и др.) и перечисляет колдунщики. Метод асинхронный: ответ на постановку — report_id. То же в интерфейсе — Анализ рекламы в выдаче Яндекса.

Режим: асинхронный: report_id
Стоимость: 3 лимита за запрос
Максимум: 100 запросов, одна задача за раз

Постановка задачи

POST /api/analizreklamyyandex

Выдача снимается с десктопа, ТОП-50. Дубли запросов отбрасываются. Пока предыдущая задача не закончилась, новая не ставится — придёт ошибка -32 с её report_id.

Параметры query и тело формы

key string обязательный

Ключ API из настроек аккаунта. Всегда в query, в том числе у POST.
queries array обязательный

Запросы, от 1 до 100. Массив или строка, по одному запросу на строке.
lr int обязательный

Регион Яндекса.

Ответ

report_id int

ID задачи для получения результата.

POST /api/analizreklamyyandex

curl -X POST 'https://tools.pixelplus.ru/api/analizreklamyyandex?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'queries[]=пиксель тулс' \
  --data-urlencode 'queries[]=seo' \
  --data-urlencode 'queries[]=разработка сайтов' \
  --data-urlencode 'lr=213'

<?php
$url = 'https://tools.pixelplus.ru/api/analizreklamyyandex?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'queries' => [
            'пиксель тулс',
            'seo',
            'разработка сайтов',
        ],
        'lr' => 213,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/analizreklamyyandex",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data=[
        ("queries[]", "пиксель тулс"),
        ("queries[]", "seo"),
        ("queries[]", "разработка сайтов"),
        ("lr", 213),
    ],
    timeout=60,
)
print(response.json())

queries обязательный Запросы, от 1 до 100 · по одному на строку lr обязательный Регион Яндекса

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "report_id": 18734523
}

Получение результата

GET /api/analizreklamyyandex

Пока задача выполняется, приходит {"error":"In progress","code":50} — повторите запрос через 10–30 секунд.

Параметры query

key string обязательный

Ключ API из настроек аккаунта. Всегда в query, в том числе у POST.
report_id int обязательный

ID задачи из ответа на постановку.

Ответ

В response ключ — запрос. Ноль и «не найдено» везде заменены строкой Нет в выдаче. Если выдачу снять не удалось, response равен null — поставьте задачу заново.

request object

Параметры задачи: queries, lr, csv (всегда false).
response.<запрос>.countPromotion object

Рекламные блоки.
Вложенные поля
- top int|string
  
  Объявлений над выдачей.
- middle int|string
  
  Объявлений внутри выдачи.
- low int|string
  
  Объявлений под выдачей.
- direct int|string
  
  Место ссылки на Яндекс Директ в органике.
- all int|string
  
  Органических результатов без сервисов Яндекса и Директа.
response.<запрос>.position object

Сервис Яндекса → его место в органике или Нет в выдаче. Всегда 25 ключей вида Яндекс.Карты (место).
response.<запрос>.koldunshiki string

Колдунщики через запятую: Карточка организации, Ответ Алисы, Факты, Смотрите также, Яндекс.Карты справа, Организации, Конвертер валют. Если нет ни одного — Нет колдунщиков.

GET /api/analizreklamyyandex

curl -G 'https://tools.pixelplus.ru/api/analizreklamyyandex' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=18734523'

<?php
$url = 'https://tools.pixelplus.ru/api/analizreklamyyandex?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 18734523,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/analizreklamyyandex",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18734523,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

Запрос настоящий — выполнится с вашим ключом

Пример ответа

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

Ошибки

Код	Сообщение	Когда
`50`	`In progress`	Задача ещё выполняется.
`-32`	`In progress`	Новая задача не поставлена: у вас уже идёт задача этого метода, её ID — в `report_id`.
`-50`	`Not set`	Не передан `lr` или `queries` (ключом приходит `lr` или `requests`), либо запрос пришёл не POST-ом.
`-67`	`To much requests`	Больше 100 запросов.
`-4`	`Access denied`	`report_id` чужой или от другого инструмента.
`-104…-107, -125`	`Processing error и др.`	Задача завершилась без результата: ошибка обработки (`-104`), кончились лимиты (`-105`), отменена (`-106`), шла дольше 6 часов (`-107`), прочее (`-125`).
`-1, -2`	`Access denied`	Ключ не передан (HTTP `404`) или не найден (HTTP `403`).
`-68, -80…-83`	`Not enough … limits`	Не хватает дневных, часовых, недельных, месячных или годовых лимитов.

Ответ с ошибкой

{
    "error": "In progress",
    "code": 50
}

Лимиты списываются при постановке, по 3 за каждый уникальный запрос, и не возвращаются, если выдачу снять не удалось. Перед постановкой проверяется только, что остаток лимитов положительный, — следите за балансом сами через getlimits.

analizreklamyyandex Реклама, сервисы Яндекса и колдунщики в выдаче по запросам

Постановка задачи

Параметры query и тело формы

Ответ

Получение результата

Параметры query

Ответ

Ошибки

`analizreklamyyandex` Реклама, сервисы Яндекса и колдунщики в выдаче по запросам