APapptweak
Keyword Suggestions

Keyword Suggestions by App

Changed on

Returns a list of recommended keywords for which an app is performing well on. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/app/keyword</th></tr></thead> <tbody> <tr><td><b>keyword</b></td><td>the keyword suggestion for your app</td><td>1</td></tr> </tbody> </table>

get/keywords/suggestions/app.json

Request

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

Query parameters

appsstring required

Comma separated list of app ids (e.g. 1095459556,835599320 or com.facebook.katana,us.zoom.videomeetings). Max 5 apps are allowed.

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.

limitinteger

Number of items to fetch (max 500). Defaults to 100.

offsetinteger

Index offset to apply to the ranking of results. Defaults to 0.

sort'score' | 'volume' | 'ranking'

The parameter by which keywords are sorted. Defaults to score. Score and volume are explained on the <a href="https://developers.apptweak.com/reference/keyword-suggestions#top-installs" target="_blank"><b>Keyword Suggestions</b></a> page.

sort_direction'desc' | 'asc'

Sorting direction for the sort parameter. Defaults to "descending" for score and volume; "ascending" for rank.

Response

Successful response.

resultobject

Changes

  • a4af4000f1e3Revision changes
    • breaking

      for the query request parameter sort, default value score was added

    • breaking

      for the query request parameter limit, default value was changed from 10 to 100

    • breaking

      for the query request parameter language, default value us was removed

    • breaking

      the response's body type changed from no type to object for status

    • info

      api tag Keyword Suggestions added

    • info

      removed subschema #1: iOS subschema #2: Android from the response body oneOf list 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