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
      }
    }
  }
}