Returns analytics data for different keywords that AppTweak gathers or estimates.
Upcoming change: AppTweak Volume Estimate (August 11, 2026)
On August 11, 2026, we are improving how keyword volume is reported across AppTweak, including the API.What's changing
volumewill return the AppTweak Volume Estimate. This is AppTweak's own estimate of keyword search demand, built from years of real volume history and additional market signals. It restores representative volumes for the many keywords the App Store now reports at the lowest tier (volume 5), so genuinely low-demand keywords and high-potential ones no longer look the same. The field name, format, and scale (5–100) are unchanged — only the values improve.- New metric:
search_popularity. Returns the App Store's raw, store-reported Search Popularity score — the values volume returned before this change. Add it to your metrics parameter if you want to keep working with the store's raw data alongside the new estimate.max_reachandinstallsimprove too. These estimates are calculated from volume, so keywords previously stuck at 0 will show meaningful values again from August 11. This reflects improved data, not a change in app performance.What's not changing
No endpoints, parameters, or response formats are modified.
max_volumecontinues to return the highest store-reported Search Popularity score.Historical data is not rewritten. The AppTweak Volume Estimate applies from August 11 onward, so history requests will show a step change on that date. There is no retroactive Volume Estimate history before August 11.
What you should do
- If you use
volumefor keyword prioritization, no action is needed — you'll automatically get more representative values.- If your integration depends on the store's raw values, request the new
search_popularitymetric from August 11.Learn more about the AppTweak Volume Estimate in our Help Center article.
Keyword metrics are numerical properties that AppTweak has been able to gather or estimate about keywords. Metrics are exposed through two endpoints:
- Keyword Metrics - Current returns the latest - most recent - data available
This endpoint returns the data for today. If AppTweak hasn't stored the data, the data will be fetched live on the store.
- Keyword Metrics - History returns the historical daily values over a given period of time.
This endpoint returns the data from AppTweak's databases. If the data is not available, you'll get a "null" response and you won't get charged credits for the datapoints.
See below for a list of available metrics.
| Metric name | Description | Origin | Historical Data Available? |
|---|---|---|---|
| volume | 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 is. Only available in countries where Apple Ads is available. | Apple Search Popularity Score | âś… |
| max_volume | Highest Search Popularity score recorded for this keyword since January 1st, 2025. | Apple Search Popularity Score | âž– |
| difficulty | A score between 1 and 100 that shows the level of competition of a keyword. The higher the number, the higher the competition. A high Difficulty score indicates that powerful apps rank in the top 10 search results, making it more difficult to rank high for the keyword. | AppTweak-defined KPI | âž– |
| brand | An object containing an app id, app title, and app icon if a keyword is branded. An empty object means that the keyword is considered generic. | AppTweak estimation | âž– |
| results | On iOS, this represents the total number of apps considered by Apple before applying their sorting algorithm. A bigger number means that more apps "match" the keyword. On Android, this is the total number of apps that AppTweak was able to fetch when making the search for a keyword. | Gathered directly from the app store pages | âś… |
| max_reach | An object containing monthly impressions estimation for a keyword and the data of the data. Not available for ipad. | AppTweak estimation | âž– |
| all_installs[DEPRECATED] | An estimation of downloads generated by searches for that keyword every month, if available for the country requested. | AppTweak estimation | âž– |