Яндекс WordStat

Прямой доступ к данным WordStat с расширенной информацией о регионах. Названия регионов уже включены в ответ — не нужно отдельно запрашивать справочник.

Заметка

Полная спецификация параметров: /api-docs

Эндпоинты

Метод	Эндпоинт	Описание
POST	/v1/wordstat/top	Популярные запросы по ключевому слову
POST	/v1/wordstat/dynamics	Динамика запросов во времени
POST	/v1/wordstat/regions	Распределение по регионам

Популярные запросы

cURL

curl -X POST "https://proxy.unoapi.ru/v1/wordstat/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phrase": "купить телефон",
    "regions": [213],
    "limit": 10
  }'

TypeScript

const response = await fetch('https://proxy.unoapi.ru/v1/wordstat/top', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phrase: 'купить телефон',
    regions: [213], // Москва
    limit: 10
  })
});

const data = await response.json();
console.log(data.topRequests);
// [{ phrase: 'купить телефон недорого', count: 45230 }, ...]

Python

import requests

response = requests.post(
    'https://proxy.unoapi.ru/v1/wordstat/top',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'phrase': 'купить телефон',
        'regions': [213],
        'limit': 10
    }
)

data = response.json()
for item in data['topRequests']:
    print(f"{item['phrase']}: {item['count']}")

Пример ответа

{
  "topRequests": [
    { "phrase": "купить телефон недорого", "count": 45230 },
    { "phrase": "купить телефон в москве", "count": 32100 },
    { "phrase": "купить телефон samsung", "count": 28500 }
  ]
}

Динамика запросов

Анализ трендов и сезонности по ключевому слову.

curl -X POST "https://proxy.unoapi.ru/v1/wordstat/dynamics" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phrase": "купить телефон",
    "period": "monthly"
  }'

Пример ответа

{
  "dynamics": [
    { "date": "2025-01", "count": 125000 },
    { "date": "2025-02", "count": 118000 },
    { "date": "2025-03", "count": 142000 }
  ],
  "trend": "up 8.2%"
}

Заметка

Периоды: monthly (12 месяцев), weekly (52 недели), daily (60 дней)

Региональное распределение

curl -X POST "https://proxy.unoapi.ru/v1/wordstat/regions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phrase": "купить телефон"}'

Пример ответа

{
  "regions": [
    {
      "regionId": 213,
      "regionName": "Москва",
      "count": 45000,
      "share": 15.2,
      "affinityIndex": 1.23
    }
  ]
}

Ответ включает regionName, parentName, countryCode — не нужно отдельно запрашивать справочник регионов.