APapptweak
Keyword Suggestions

Trending Keyword Suggestions

Changed on

Returns the keywords the app store shows in its search results before the user has typed anything. The list is store-wide and cannot be scoped to an app or a category. It depends on the requested country, language, device and date range: the trending lists published over that range are fetched, a keyword's <code>occurrences</code> counts how often it appeared in them, and <code>offset</code> and <code>limit</code> page through the keywords in that order. To get suggestions for a specific app or category, use <b>Keyword Suggestions by App</b> or <b>Keyword Suggestions by Category</b>. <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>Object containing a trending keyword and its number of occurrences</td><td>10</td></tr> </tbody> </table> <Callout icon="📘" theme="info"><b>Only available for iOS devices</b><p>Trending keyword suggestions are only available for iPhone and iPad devices.</p></Callout>

get/keywords/suggestions/trending.json

Request

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

Query parameters

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'

Choose a device from iphone or ipad. 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.

start_datestring date

Start date (YYYY-MM-DD). Defaults to 30 days ago.

end_datestring date

End date (YYYY-MM-DD). Defaults to yesterday.

Response

Successful response.

Changes

  • a4af4000f1e3Revision changes
    • breaking

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

    • breaking

      for the query request parameter end_date, default value 2022-04-15 was removed

    • breaking

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

    • breaking

      for the query request parameter start_date, default value 2022-04-08 was removed

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

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

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

      api tag Keyword Suggestions added

    • 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

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status