Keyword Metrics - Current
Changed onGet the most recent metrics of a keyword (volume, max volume, search popularity, difficulty, brand, total results, max reach). <br/><br/> Please see the History section if you would like to have historical data for keywords. <br/><br/> <Callout icon="📘" theme="info"><b><code>volume</code> returns the AppTweak Volume Estimate</b><p><code>volume</code> returns the AppTweak Volume Estimate, on the same 5-100 scale as before. Request <code>search_popularity</code> for the App Store's raw, store-reported score.</p><p><code>search_popularity</code> is only available in countries where <a href="https://ads.apple.com/app-store/countries-and-regions" target="_blank"><b>Apple Ads</b></a> is available, and is rejected for <code>device=android</code>: Google Play publishes no equivalent. Use <code>volume</code> for Android keyword volume.</p></Callout> <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/kw</th></tr></thead> <tbody> <tr><td><b>volume</b></td><td>An object containing the AppTweak Volume Estimate of how popular the keyword is in Search, on a scale from 5 to 100, and the date of the data.</td><td>10</td></tr> <tr><td><b>difficulty</b></td><td>An object containing the keyword difficulty and the date of the data.</td><td>10</td></tr> <tr><td><b>brand</b></td><td>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.</td><td>10</td></tr> <tr><td><b>results</b></td><td>An object containing the number of search results for a keyword and the date of the data.</td><td>10</td></tr> <tr><td><b>max_reach</b></td><td>An object containing monthly impressions estimation for a keyword and the data of the data. Not available for ipad.</td><td>10</td></tr> <tr><td><b>max_volume</b></td><td>Highest store-reported Search Popularity score recorded for this keyword since January 1st, 2025.</td><td>10</td></tr> <tr><td><b>search_popularity</b></td><td>An object containing the App Store's raw, store-reported Search Popularity score and the date of the data. 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.</td><td>10</td></tr> <tr><td><b>all_installs [DEPRECATED]</b></td><td>An object containing monthly installs estimation for a keyword and the date of the data. Not available for ipad.</td><td>10</td></tr> </tbody> </table>
Request
- Base URLhttps://public-api.apptweak.com/api/public/store
- URLhttps://public-api.apptweak.com/api/public/store/keywords/metrics/current.json
- AuthAPI key in header x-apptweak-key
Query parameters
Comma-separated list of keywords (e.g. music,podcasts,songs). Max 10 keywords are allowed.
Comma separated list of metrics. Available metrics are listed in the table above (e.g. volume,difficulty,all_installs)
Two-letter country code (us, gb, fr). Accepted values: <a href="https://developers.apptweak.com/reference/countries-1" target="_blank"><code>GET /api/public/apptweak/countries</code></a> with store=ios or store=android. Defaults to us.
AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: <a href="https://developers.apptweak.com/reference/languages-1" target="_blank"><code>GET /api/public/apptweak/languages</code></a> with store=ios or store=android. Defaults to the country's <a href="https://developers.apptweak.com/reference/languages-overview#default-language" target="_blank"><b>default language</b></a>.
Choose a device from iphone, ipad or android. Defaults to iphone.
Response
Successful response.
Changes
- breaking
for the
queryrequest parameterlanguage, default valueuswas removed - breaking
the response's body type changed from no type to
objectfor status - info
api tag
Keyword Metricsadded - info
removed
subschema #1: iOS - iphonesubschema #2: Androidsubschema #3: iOS - ipadfrom the response bodyoneOflist for the response status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- breaking