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

`aianswers` Проверка ИИ-ответов Яндекса и Google по списку запросов

Для каждого запроса проверяет, показывают ли Яндекс (нейроответ Алисы) и Google (блок AI Overview) ИИ-ответ, и возвращает его текст, источники и место вашего сайта среди них — как инструмент «Проверка Алисы и AI Overview». Метод асинхронный: POST с JSON возвращает report_id, результат забирается тем же методом. Тот же метод доступен по адресу /api/iiotvety.

Режим: асинхронный: report_id
Стоимость: за запрос в каждой системе: Яндекс — 4, Google — 9, онлайн-Алиса — 750
Объём: до 1000 запросов и 6 систем-регионов
Тело: JSON
Тариф: только платные тарифы, до 5 задач одновременно

Справочник регионов и языков

GET /api/aianswers

Допустимые значения ss, коды регионов lr для каждой системы и языки Google. Задачу не ставит, лимиты не тратит.

Параметры query

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

Любое непустое значение.

Ответ

ss[] array

Поисковые системы: name, value.
lr.yandex[], lr.google[] array

Регионы каждой системы: name, value — код для lr.
languages.google[] array

Языки Google: name, value — код для language.

GET /api/aianswers

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

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

$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/aianswers",
    params={
        "key": "ВАШ_КЛЮЧ",
        "options": "true",
    },
    timeout=60,
)
print(response.json())

options обязательный Любое непустое значение

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

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

{
    "ss": [
        {
            "name": "Яндекс",
            "value": "yandex"
        },
        {
            "name": "Google",
            "value": "google"
        }
    ],
    "lr": {
        "yandex": [
            {
                "name": "Москва",
                "value": 213
            },
            {
                "name": "Санкт-Петербург",
                "value": 2
            }
        ],
        "google": [
            {
                "name": "Москва",
                "value": 213
            }
        ]
    },
    "languages": {
        "google": [
            {
                "name": "Русский",
                "value": "ru"
            },
            {
                "name": "Английский",
                "value": "en"
            }
        ]
    }
}

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

POST /api/aianswers

Тело — JSON-объект; поля формы метод не читает. Ключ — в адресе.

Параметры query и JSON-тело

requests array обязательный

Поисковые запросы, от 1 до 1000.
searchSystems array обязательный

Поисковые системы и регионы, от 1 до 6 элементов. Одна система может повторяться с разными регионами.
Вложенные поля
- ss string обязательный
  
  yandex или google.
- lr string обязательный
  
  Код региона из справочника для этой системы, например 213 — Москва.
- language string
  
  Язык интерфейса Google из справочника, например ru. Обязателен для google.
url string

Ваш сайт: для него считается position среди источников ответа.
subdomains bool

true — поддомены считаются вашим сайтом: blog.example.com засчитывается за example.com.

По умолчанию false
collect_online bool

Только Яндекс. false — нейроответы из обычного поиска, только по популярным информационным запросам. true — режим «Поиск с Алисой»: ответ запрашивается для любых запросов, включая коммерческие и редкие. Цена — 750 вместо 4 за запрос.

По умолчанию false
collect_google_ai_mode bool

Только Google. true — если блока AI Overview в выдаче нет, взять ответ из вкладки «Режим ИИ». На цену не влияет.

По умолчанию false

POST /api/aianswers

curl -X POST 'https://tools.pixelplus.ru/api/aianswers?key=ВАШ_КЛЮЧ' \
  -H 'Content-Type: application/json' \
  -d '{
      "requests": [
          "куда сходить в москве",
          "куда сходить недорого"
      ],
      "searchSystems": [
          {
              "ss": "yandex",
              "lr": "213"
          },
          {
              "ss": "google",
              "lr": "213",
              "language": "ru"
          }
      ],
      "url": "https://example.com/"
  }'

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

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'requests' => [
            'куда сходить в москве',
            'куда сходить недорого',
        ],
        'searchSystems' => [
            [
                'ss' => 'yandex',
                'lr' => '213',
            ],
            [
                'ss' => 'google',
                'lr' => '213',
                'language' => 'ru',
            ],
        ],
        'url' => 'https://example.com/',
    ]),
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/aianswers",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    json={
        "requests": [
            "куда сходить в москве",
            "куда сходить недорого",
        ],
        "searchSystems": [
            {
                "ss": "yandex",
                "lr": "213",
            },
            {
                "ss": "google",
                "lr": "213",
                "language": "ru",
            },
        ],
        "url": "https://example.com/",
    },
    timeout=60,
)
print(response.json())

requests обязательный Поисковые запросы, от 1 до 1000 · по одному на строку searchSystems обязательный

[
    {
        "ss": "yandex",
        "lr": "213"
    },
    {
        "ss": "google",
        "lr": "213",
        "language": "ru"
    }
]

Поисковые системы и регионы, от 1 до 6 элементов url Ваш сайт: для него считается position среди источников ответа

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

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

{
    "report_id": 18452301
}

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

GET /api/aianswers

Повторяйте раз в 10–30 секунд: сбор идёт порциями, большая задача занимает десятки минут.

Параметры query

report_id int обязательный

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

Ответ

request object

Параметры задачи: requests, url, searchSystems, collect_online, collect_google_ai_mode — в том виде, в каком задача выполнялась.
response.success bool

false — не удалось собрать ни одной строки; текст в response.error, лимиты не списаны.
response.cost int

Сколько лимитов списано.
response.data object

Результаты по регионам. Ключ — код региона.
Вложенные поля
- region_info string
  
  Название региона.
- requests object
  
  Ключ — запрос, внутри — ответы по системам yandex и google.
  Вложенные поля
  - has_answer bool
    
    Есть ли ИИ-ответ в выдаче.
  - answer string|null
    
    Текст ответа; может содержать HTML-разметку.
  - collect_error string|null
    
    Текст ошибки, если ответ не удалось собрать. null — проверка прошла (в том числе когда ответа в выдаче нет). Строки с ошибкой не оплачиваются.
  - position int|null
    
    Место сайта из url среди источников ответа, с 1. Сравнивается домен, не адрес страницы. null — url не передан или сайта среди источников нет.
  - links array
    
    Источники ответа: url, domain, favicon.
time string

Время готовности.
cost int

Сколько лимитов списано за задачу. При response.success = false показывает расчётную цену, хотя списания не было.

GET /api/aianswers

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

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

$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/aianswers",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18452301,
    },
    timeout=60,
)
print(response.json())

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

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

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

{
    "request": {
        "requests": [
            "куда сходить в москве"
        ],
        "url": "https://example.com/",
        "searchSystems": [
            {
                "ss": "yandex",
                "lr": "213"
            },
            {
                "ss": "google",
                "lr": "213",
                "language": "ru"
            }
        ],
        "collect_online": false,
        "collect_google_ai_mode": false
    },
    "response": {
        "success": true,
        "error": null,
        "cost": 13,
        "data": {
            "213": {
                "region_info": "Москва",
                "requests": {
                    "куда сходить в москве": {
                        "yandex": {
                            "has_answer": true,
                            "collect_error": null,
                            "answer": "В Москве стоит посетить Третьяковскую галерею, парк «Зарядье»…",
                            "position": 2,
                            "links": [
                                {
                                    "url": "https://afisha.example.ru/msk/",
                                    "domain": "afisha.example.ru",
                                    "favicon": "https://tools.pixelplus.ru/projects/shared/getfavicon/afisha.example.ru"
                                },
                                {
                                    "url": "https://example.com/moscow/",
                                    "domain": "example.com",
                                    "favicon": "https://tools.pixelplus.ru/projects/shared/getfavicon/example.com"
                                }
                            ]
                        },
                        "google": {
                            "has_answer": false,
                            "collect_error": null,
                            "answer": null,
                            "position": null,
                            "links": []
                        }
                    }
                }
            }
        }
    },
    "time": "2026-10-06 15:02:44",
    "cost": 13
}

Ошибки

Код	Сообщение	Когда
`-100`	`tools errors`	Задача не поставлена, причины в `details`: число запросов не от 1 до 1000, систем — не от 1 до 6, неизвестная система, регион или язык, бесплатный тариф.
`-91`	`Invalid JSON: …`	Тело запроса — не JSON (например, передано полями формы).
`-60`	`tools errors`	Уже 5 незавершённых задач (`MAX_PARALLEL_TASKS_FAIL`).
`-51`	`No requests data`	Задача ставится не POST-запросом.
`50`	`In progress`	Задача ещё идёт; `progress` — процент готовности.
`-4`	`Access denied`	`report_id` чужой или другого инструмента.
`-104…-107, -125`	`Processing error и др.`	Задача завершилась сбоем — см. асинхронные задачи.
`-101`	`Unexpected error`	Непредвиденный статус задачи.
`-68, -80…-83`	`Not enough … limits`	Лимиты закончились — метод не отвечает даже на справочник и чтение отчёта.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

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

{
    "error": "tools errors",
    "details": [
        "Ошибка! Неправильно выбранный регион (99999)."
    ],
    "code": "-100"
}

Стоимость

Строка отчёта	Лимитов
Запрос × Яндекс	4
Запрос × Яндекс, `collect_online: true`	750; 4, если ответ взят из обычной выдачи, а не у онлайн-Алисы
Запрос × Google (с `collect_google_ai_mode` или без)	9

Пример: 10 запросов × (Яндекс + Google) = 10 × (4 + 9) = 130 лимитов. Лимиты списываются по завершении задачи и только за собранные строки: «ответа в выдаче нет» оплачивается, сорванный сбор (collect_error) — нет. При постановке достаточность лимитов на весь объём не проверяется — следите за балансом сами.

Ограничения

Флаги передавайте JSON-булевыми true/false: строка "false" считается включённой опцией.
Регионы, которых нет в справочнике выбранной системы, отклоняются при постановке.
/api/aianswers и /api/iiotvety — один и тот же метод; отчёты, поставленные через один адрес, читаются через другой.

aianswers Проверка ИИ-ответов Яндекса и Google по списку запросов

Справочник регионов и языков

Параметры query

Ответ

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

Параметры query и JSON-тело

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

Параметры query

Ответ

Ошибки

Стоимость

Ограничения

`aianswers` Проверка ИИ-ответов Яндекса и Google по списку запросов