API парсинга частотности из Яндекс.Вордстат
Для инструмента «Сбор частотности Яндекс Вордстат» обязательные параметры:
Параметр |
Значение | Описание |
tools_name= | wordstat | Название инструмента |
type= | 1 | Тип проверки (1 - проверка частотности) |
queries= | массив в формате JSON | Фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"] |
lr= | 213 (Москва) | Основной регион поиска по Яндексу |
lr2= | lr региона | Второй дополнительный регион поиска по Яндексу. |
lr3= | lr региона | Третий дополнительный регион поиска по Яндексу. |
base= | true/false | Получение основной частоты (WS) по запросам. Значения указывать как указаны в поле. |
quoted= | true/false | Получение частоты "WS" по запросам. |
overal= | true/false | Получение частоты "!WS" по запросам. |
exact= | true/false | Получение частоты "[!WS]" по запросам. |
device= | desktop/mobile/phone/tablet | Уточнение устройства для сбора частоты. Чтобы указать все устройства, указывайте пустое поле. |
Пример PHP кода:
<?php
// Параметры API
$token = "ВАШ_ТОКЕН"; // Замените ВАШ_ТОКЕН на ваш реальный токен
$tools_name = "wordstat";
$type = 1; // 1 - проверка частотности, 2 - парсинг запросов, 3 - проверка сезонности
$queries = ["купить флаг", "купить что-нибудь", "купить плащ"];
$lr = 213;
$lr2 = 12;
$lr3 = 47;
$base = 'true';
$quoted = 'true';
$overall = 'true';
$exact = 'true';
$device = ""; // desktop/mobile/phone/tablet. Пустое значение - all.
// Формирование 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,
'lr2' => $lr2,
'lr3' => $lr3,
'base' => $base,
'quoted' => $quoted,
'overal' => $overall,
'exact' => $exact,
'device' => $device
);
// Отправка запроса методом 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 задачи
Возвращает JSON с результатами проверки, пример ответа сбора частотности по региону Москва:
{
"device": "desktop",
"task_id": "21444674",
"cb": {
"base": true,
"overall": false,
"exact": false,
"exact_": false
},
"cb_count": 1,
"queries": [
"что такое seo"
],
"regions": {
"213": "Москва"
},
"result": {
"что такое seo": {
"213": {
"base": 20357
}
}
}
}