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

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

  • HTTP request
  • Body parameters
  • Response
  • PhraseInfo
  1. Справочник API
  2. API
  3. REST (англ.)
  4. Wordstat
  5. GetTop

Web Search API, REST: Wordstat.GetTop

Статья создана
Yandex Cloud
Обновлена 15 декабря 2025 г.
  • HTTP request
  • Body parameters
  • Response
  • 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.

HTTP requestHTTP request

POST https://searchapi.api.yandexcloud.kz/v2/wordstat/topRequests

Body parametersBody parameters

{
  "phrase": "string",
  "numPhrases": "string",
  "regions": [
    "string"
  ],
  "devices": [
    "string"
  ],
  "folderId": "string"
}

Field

Description

phrase

string

Required field. Keyword

The maximum string length in characters is 400.

numPhrases

string (int64)

Number of the phrases in the response.

Acceptable values are 1 to 2000, inclusive.

regions[]

string

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

The maximum number of elements is 100.

devices[]

enum (Device)

A list of device types a query was made from.

The maximum number of elements is 3.

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

folderId

string

ID of the folder.

The maximum string length in characters is 50.

ResponseResponse

HTTP Code: 200 - OK

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

Field

Description

totalCount

string (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

string (int64)

Number of queries made.

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

Предыдущая
Overview
Следующая
GetDynamics
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»