Top Requests
AI-generatedSummary
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®ions=[213,2]&devices=["desktop","phone"]