Web Search API, REST: Wordstat.GetTop
Written by
Updated at November 21, 2025
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 request
POST https://searchapi.api.cloud.yandex.net/v2/wordstat/topRequests
Body parameters
{
"phrase": "string",
"numPhrases": "string",
"regions": [
"string"
],
"devices": [
"string"
],
"folderId": "string"
}
|
Field |
Description |
|
phrase |
string Required field. Keyword |
|
numPhrases |
string (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.
|
|
folderId |
string ID of the folder. |
Response
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[] |
Results. |
|
associations[] |
Queries that are similar to the specified one. |
PhraseInfo
|
Field |
Description |
|
phrase |
string Keyword. |
|
count |
string (int64) Number of queries made. |