Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Search API
  • Getting started
  • Access management
  • Pricing policy
    • Authentication in the API
        • Overview
          • Overview
          • GetTop
          • GetDynamics
          • GetRegionsDistribution
          • GetRegionsTree
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • GetTopRequest
  • GetTopResponse
  • PhraseInfo
  1. API reference
  2. API
  3. gRPC
  4. Wordstat
  5. GetTop

Web Search API, gRPC: WordstatService.GetTop

Written by
Yandex Cloud
Updated at December 15, 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

The maximum string length in characters is 400.

num_phrases

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.

folder_id

string

ID of the folder.

The maximum string length in characters is 50.

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.

Was the article helpful?

Previous
Overview
Next
GetDynamics
© 2025 Direct Cursus Technology L.L.C.