Wordstat icon

Wordstat

Interact with Yandex Wordstat API

Top Requests

AI-generated

Summary

Get popular search phrases containing a given phrase

Inputs

  • phrase (required) — The phrase to search for. Supports operators like "+".
  • numPhrases — Number of phrases in response. Default is 50, max is 2000.
  • regions — List of region IDs (e.g. [213, 2]). Default is all regions.
  • devices — List of device types. If empty, defaults to all.

Output shape

an array of request objects

Each object represents a top request and includes fields such as phrase and hits; the exact structure may vary.

Examples

Example 1: Get top requests for the phrase "online marketing" with 100 results

phrase=online marketing&numPhrases=100

Example 2: Retrieve dynamics for phrase "AI" over the past month

phrase=AI&period=monthly&fromDate=2023-01-01&toDate=2023-01-31

Example 3: List top requests across specific regions and devices

phrase=technology&regions=[213,2]&devices=["desktop","phone"]

Discussion