App Keyword Ranking - Current
Changed on<b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Comment</th><th>Credits/app/keyword</th></tr></thead> <tbody> <tr><td><b>rank</b></td><td>Ranking of an app for a keyword.</td><td>10</td></tr> <tr><td><b>installs</b></td><td>The estimated number of daily installs driven by a keyword to an app.</td><td>10</td></tr> <tr><td><b>relevancy</b></td><td>The relevancy score is an indicator between 0 and 100, indicating how relevant a keyword is for your app.</td><td>10</td></tr> <tr><td><b>chance</b></td><td>A score between 1 and 100 that indicates how likely your app is to rank in the top 10 search results for the selected keyword.</td><td>10</td></tr> <tr><td><b>kei</b></td><td>KEI (Keyword Efficiency Index): A score that indicates the visibility potential of a keyword, taking into account keyword volume and chance score.</td><td>10</td></tr> </tbody> </table> <Callout icon="📘" theme="info"><b>Ranked, unranked or no data</b><p>To know whether your app is ranked on a keyword or not, you can refer to the following logic in the response data:</p><p>• <code>value</code> = non-null and <code>fetch_performed</code> = <code>true</code> ➔ ranked<br/>• <code>value</code> = <code>null</code> and <code>fetch_performed</code> = <code>true</code> ➔ unranked<br/>• <code>value</code> = <code>null</code> and <code>fetch_performed</code> = <code>false</code> ➔ no data</p><p>In addition to <code>value</code>, <b>you can use <code>effective_value</code>, that corresponds to a value that is guaranteed to be non-null</b>. <code>effective_value</code> is equal to <code>value</code>, or defaults to <code>501</code> if <code>value</code> = <code>null</code>.</p></Callout>
Request
- Base URLhttps://public-api.apptweak.com/api/public/store
- URLhttps://public-api.apptweak.com/api/public/store/apps/keywords-rankings/current.json
- AuthAPI key in header x-apptweak-key
Query parameters
Comma separated list of app ids (1095459556,835599320 or com.facebook.katana,us.zoom.videomeetings). Max 5 apps are allowed.
Comma separated list of keywords. Max 5 keywords are allowed.
Comma separated list of metrics (rank, installs, relevancy, kei, chance).
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
- info
api tag
Keyword Metrics by Appadded - 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