---
title: SearchTermPopularityQueryRequest
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/searchtermpopularityqueryrequest
---

# SearchTermPopularityQueryRequest

Request body for the search term popularity query endpoint.

## Declaration

```data
object SearchTermPopularityQueryRequest
```

## Properties

filters: Filter conditions to scope results to specific countries or genres. See Filterable Fields for genre values matching App Store genre names. sorting: Sort criteria. Maximum two sort fields. Default genre ASC, rankInGenre ASC. timeRange: timeRange is required and specifies the date window to query. Timezone is fixed to UTC. See SearchTermPopularityTimeRange for granularity rules. pagination: See RequestPagination for details. This endpoint caps pageSize at 5000.

## Example

Example {   "fields": [     "rankInGenre",     "searchPopularityInGenre",     "searchPopularity1to100",     "searchPopularity1to5"   ],   "filters": [     {       "field": "countryOrRegion",       "operator": "EQUALS",       "value": "US"     },     {       "field": "genre",       "operator": "EQUALS",       "value": "PRODUCTIVITY_UTILITIES"     }   ],   "sorting": [     {       "field": "rankInGenre",       "order": "ASC"     }   ],   "timeRange": {     "start": "2025-01-05",     "end": "2025-01-11",     "granularity": "WEEKLY_SUN_SAT"   },   "pagination": {     "offset": 0,     "pageSize": 20   } }

## See Also

- [ImpressionShareQueryRequest](apple-ads-platform-api/impressionsharequeryrequest.md)
- [ImpressionShareQueryResponse](apple-ads-platform-api/impressionsharequeryresponse.md)
- [ImpressionShareRow](apple-ads-platform-api/impressionsharerow.md)
- [ImpressionShareTimeRange](apple-ads-platform-api/impressionsharetimerange.md)
- [ImpressionShareOptions](apple-ads-platform-api/impressionshareoptions.md)
- [SearchTermPopularityQueryResponse](apple-ads-platform-api/searchtermpopularityqueryresponse.md)
- [SearchTermPopularityRow](apple-ads-platform-api/searchtermpopularityrow.md)
- [SearchTermPopularityTimeRange](apple-ads-platform-api/searchtermpopularitytimerange.md)
- [ImpressionShareResultContainer](apple-ads-platform-api/impressionshareresultcontainer.md)
- [SearchTermPopularityResultContainer](apple-ads-platform-api/searchtermpopularityresultcontainer.md)
- [KeywordInsights](apple-ads-platform-api/keywordinsights.md)
- [ReportingKeywordBidRecommendation](apple-ads-platform-api/reportingkeywordbidrecommendation.md)