---
title: Search Term Popularity Query
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/query-app-search-term-popularity-data
---

# Search Term Popularity Query

Retrieve the relative search volume ranking of search terms for a given App Store genre and country or region.

## URL

POST https://api.ads.apple.com/v1/insights/apps/search-term-popularity/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful response. Returns SearchTermPopularityQueryResponse (result: SearchTermPopularityResultContainer). 400 Bad Request: Bad Request. Returns Error. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Not Found. Returns Error. 429 Too Many Requests: Rate Limit Exceeded. Returns Error. 500 Internal Server Error: Internal Server Error. Returns Error.

## Discussion

Discussion This endpoint returns the most popular search terms for a given App Store genre and country, showing top search terms by search volume. To discover high-volume terms to target during campaign setup, use this data. See Filter for the full set of supported comparison operators. Filterable Fields  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |  Sortable Fields All fields are sortable. There is a maximum two sort fields per request.  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  Payload Examples

## See Also

- [Impression Share Query](apple-ads-platform-api/query-app-impression-share-data.md)