Trending Keyword Suggestions

⚠️

Upcoming change — January 19, 2027

Following our recent Public API pricing update, this endpoint's request limit will change:

  • Date range: Each request can cover a maximum of one year.

Please split requests covering longer periods into smaller calls.



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 occurrences counts how often it appeared in them, and offset and limit page through the keywords in that order. To get suggestions for a specific app or category, use Keyword Suggestions by App or Keyword Suggestions by Category.

Price

DataCreditsPer
Trending keywords5request


Any date range up to 1 year costs the same.
📘Only available for iOS devices

Trending keyword suggestions are only available for iPhone and iPad devices.

Query Params
string
Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. Defaults to us.

string

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: GET /api/public/apptweak/languages with store=ios or store=android. Defaults to the country's default language.

string
enum
Defaults to iphone

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

Allowed:
int32
Defaults to 100

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

int32
Defaults to 0

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

date

Start date (YYYY-MM-DD). Send both dates or omit both. Defaults to 30 days ago.

date

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

Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Not enough credits to perform the request.

422

Validation error. Returned when a parameter is invalid.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json