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

Запрос для проверки ответов Алисы и AI Overview в Яндексе и Google с помощью инструмента https://tools.pixelplus.ru/tools/ii-otvety.

Описание параметров:

requests — Массив поисковых запросов для проверки (обязательно). Допустимо от 1 до 1000 запросов.
searchSystems — Массив объектов с настройками поисковых систем (обязательно). Допустимо от 1 до 6 элементов.
searchSystems[].ss — Поисковая система (обязательно). Допустимые значения: yandex, google.
searchSystems[].lr — Код региона для выбранной поисковой системы (обязательно). Например: 213 (Москва), 2 (Санкт-Петербург).
searchSystems[].language — Язык интерфейса (обязательно только для Google). Например: ru, en, de, fr.
url — URL вашего сайта (необязательно). Если указан, то в результатах будет показана позиция вашего сайта в источниках AI-ответа.

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

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

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://tools.pixelplus.ru/api/aianswers?key={key}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode(array(
        'requests' => array(
            'куда сходить',
            'куда сходить недорого',
        ),
        'url' => 'https://example.com/',
        'searchSystems' => array(
            array(
                'ss' => 'yandex',
                'lr' => '213'
            ),
            array(
                'ss' => 'google',
                'lr' => '213',
                'language' => 'ru'
            )
        )
    )),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

2. Получение ответа:

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://tools.pixelplus.ru/api/aianswers?key={key}&report_id=' . $reportId,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

3. Получение опций для запроса: поисковые системы, регионы, языки:

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://tools.pixelplus.ru/api/aianswers?key={key}&options=true',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;