Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ИИ для бизнеса
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Search API
  • Начало работы
  • Управление доступом
  • Правила тарификации
    • Аутентификация в API
        • Overview
          • Overview
          • GetTop
          • GetDynamics
          • GetRegionsDistribution
  • Аудитные логи Audit Trails
  • История изменений

В этой статье:

  • gRPC request
  • GetTopRequest
  • GetTopResponse
  • PhraseInfo
  1. Справочник API
  2. API
  3. gRPC (англ.)
  4. Wordstat
  5. GetTop

Web Search API, gRPC: WordstatService.GetTop

Статья создана
Yandex Cloud
Обновлена 21 ноября 2025 г.
  • gRPC request
  • GetTopRequest
  • GetTopResponse
  • PhraseInfo

Not implemented.
The method returns the last 30 days data about popular queries containing the specified keyword and queries that are similar to the specified one.

gRPC requestgRPC request

rpc GetTop (GetTopRequest) returns (GetTopResponse)

GetTopRequestGetTopRequest

{
  "phrase": "string",
  "num_phrases": "int64",
  "regions": [
    "string"
  ],
  "devices": [
    "Device"
  ],
  "folder_id": "string"
}

Field

Description

phrase

string

Required field. Keyword

num_phrases

int64

Number of the phrases in the response.

regions[]

string

A list of IDs of the regions a query was made from.

devices[]

enum Device

A list of device types a query was made from.

  • DEVICE_UNSPECIFIED
  • DEVICE_ALL: All devices.
  • DEVICE_DESKTOP: Desktop computers.
  • DEVICE_PHONE: Phones.
  • DEVICE_TABLET: Tablets.

folder_id

string

ID of the folder.

GetTopResponseGetTopResponse

{
  "total_count": "int64",
  "results": [
    {
      "phrase": "string",
      "count": "int64"
    }
  ],
  "associations": [
    {
      "phrase": "string",
      "count": "int64"
    }
  ]
}

Field

Description

total_count

int64

Total number of the queries that contain all the keywords, regardless of their order.

results[]

PhraseInfo

Results.

associations[]

PhraseInfo

Queries that are similar to the specified one.

PhraseInfoPhraseInfo

Field

Description

phrase

string

Keyword.

count

int64

Number of queries made.

Была ли статья полезна?

Предыдущая
Overview
Следующая
GetDynamics
Проект Яндекса
© 2025 ООО «Яндекс.Облако»