Keyword Live Search - History

Returns historical app results of a search for a given keyword.

For each day in the requested period, this query will return the search result if AppTweak made a search on that date for that keyword.

Please see the Current section if you want to perform a live search for given keywords.

Price

DatapointsDescriptionCredits for 1 dayCredits per extra day
-List of app IDs that rank on that keyword. The list starts with the app that ranks first for the keyword.505
📘Note that the default selected period is 30 days; however you can provide your own date range in order to extend/shorten the targeted period.

Query Params
string
required

The keyword to search for. Only one keyword is allowed.

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, ipad or android. Defaults to iphone.

Allowed:
date

Start date (YYYY-MM-DD). 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
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json