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 задачи