APapptweak
Keywords Overview

Keywords Overview

Changed on

Returns ranked keyword data for an app over a date range. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits per keyword and per day</th></tr></thead> <tbody> <tr><td><b>keyword dictionary</b></td><td>Object containing keyword, date, rank, volume, installs & branded_application_id</td><td>1</td></tr> </tbody> </table> <br/><br/> <b>Good to know</b> <br/><br/> • Available only for apps followed in the AppTweak ASO tool under an Enterprise plan; an app tracked through the API alone answers 404.<br/>• The data is refreshed every 7 days.<br/>• Available only in the Apple Ads countries, for both stores.<br/>• Returns up to the 10,000 most relevant keywords over one year, in no particular order.

get/apps/keywords/overview.json

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/apps/keywords/overview.json
  • Auth
    API key in header x-apptweak-key

Query parameters

appstring required

App ID. <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank"><b>How to find App IDs?</b></a>

countrystring

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.

languagestring

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>.

device'iphone' | 'ipad' | 'android'

Choose a device from iphone, ipad or android. Defaults to iphone.

start_datestring date

Start date (YYYY-MM-DD). Must be within the last 366 days.

end_datestring date

End date (YYYY-MM-DD). Must be before today. Maximum range is 366 days.

keyword_limitinteger

Maximum number of keywords to return (1–100). Defaults to 100.

keyword_offsetinteger

Number of keywords to skip for pagination. Defaults to 0.

Response

Successful response.

Changes