API парсинга сезонности из Яндекс Вордстат

Для инструмента «Проверка сезонности запросов» параметры API для сбора данных:

Параметры Значение Описание
tools_name= wordstat Название инструмента
type= 3  Тип проверки (3 - проверка сезонности)
queries= массив в формате JSON Фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"]
lr= lr региона по идентификатору Яндекса Регион поиска по Яндексу. Например, Москва - 213, Россия - 225
device= desktop/mobile/phone/tablet Уточнение устройства для парсинга сезонности. Чтобы указать все устройства, указывайте пустое значение.
$i_type= month/week/day Группировка данных по месяцам, неделям, дням.
$start= "2018-01-01" Начальная дата
$end= "2025-03-31" Конечная дата

ВАЖНО для получения правильной статистики:

  • Статистика «по дням» доступна только для 60 дней без учета текущего дня. Минимальный период для построения графика с выбранной детализацией — три календарных дня.
  • Статистика «по неделям» доступна только для полных календарных недель. Минимальный период для построения графика с выбранной детализацией — три календарных недели.
  • Статистика «по месяцам» доступна только для полных календарных месяцев. Минимальный период для построения графика с выбранной детализацией — три календарных месяца.

 

Пример PHP кода:

<?php

// Параметры API
$token = "ВАШ_ТОКЕН"; // Замените ВАШ_ТОКЕН на ваш реальный токен
$tools_name = "wordstat";
$type = 3; // 1 - проверка частотности, 2 - парсинг запросов, 3 - проверка сезонности
$queries = ["купить флаг", "купить что-нибудь", "купить плащ"];
$lr = 213;
$device = ""; // Пустое значение - Все устройства, можно указать desktop и mobile.
$i_type="month"; //week/day
$start = "2018-01-01";
$end = "2025-03-31";

// Формирование URL для отправки запроса методом GET
$url_get = "https://arsenkin.ru/tools/api/task/set?token={$token}&tools_name={$tools_name}";

// Формирование параметров запроса методом POST
$params_post = array(
	'version' => 2,
    'type' => $type,
    'queries' => json_encode($queries), // Преобразование в JSON
    'lr' => $lr,
    'device' => $device,
	'i_type' => $i_type,
	'startdate' => $start,
	'enddate' => $end,
);

// Отправка запроса методом POST
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url_get);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params_post));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
if ($response === false) {
    echo "Ошибка при выполнении запроса: " . curl_error($ch);
} else {
    // Обработка ответа от API (например, преобразование из JSON)
    $result = json_decode($response, true);
    
    // Вывод результата
    print_r($result);
}
?>

 

Проверка статуса задачи: осуществляется посредством GET запроса на url https://arsenkin.ru/tools/api/task/check

https://arsenkin.ru/tools/api/task/check?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Обязательные параметры:

  • task_id=12345 - ID задачи

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

Осуществляется посредством GET запроса на url https://arsenkin.ru/tools/api/task/result

https://arsenkin.ru/tools/api/task/result?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Обязательные параметры:

  • task_id=12345 - ID задачи