Get historical metrics of a keyword (volume) for a given date range. If you want to have live data for keyword metrics, please see Keyword Metrics - Current
See also: Volume History - multi-countries extract (Recipe)
What volume carries over a rangevolume returns the AppTweak Volume Estimate from August 12, 2026 onward. Earlier days keep the store-reported score, which is not rewritten, so a range spanning that date shows a step change. Request search_popularity for the App Store's raw, store-reported score.
search_popularity is only available in countries where Apple Ads is available, and is rejected for device=android: Google Play publishes no equivalent. Use volume for Android keyword volume.
Android volume history starts on February 10, 2024.
Price
| Metrics | Description | Credits/kw for 1 day | Credits/kw per extra day |
|---|---|---|---|
| volume | Hash containing the AppTweak Volume Estimate of how popular the keyword is in Search, on a scale from 5 to 100, and the associated date. | 10 | 1 |
| results | Hash containing the number of results and the associated date. | 10 | 1 |
| max_reach | Hash containing the max reach and the associated date. | 10 | 1 |
| search_popularity | Hash containing the App Store's raw, store-reported Search Popularity score and the associated date. A score between 5 and 100 that shows how popular a keyword is in terms of searches — the higher the number, the more popular the keyword. Only available in countries where Apple Ads is available, and not for android. | 10 | 1 |
Unauthorized. Unknown or missing API token.
Forbidden. Not enough credits to perform the request.
Validation error. Returned when a parameter is invalid, and when search_popularity is requested with device=android.