API Reference
My API token 🔑

Keyword Live Search - Current

get
https://public-api.apptweak.com/api/public/store/keywords/search-results/current

Returns the organic app results of a live search on the store for a given keyword.

You can find historical top apps in the Historical section.

Price

DatapointDescriptionCredits/request
-List of app IDs that rank on that keyword. The list starts with the app that ranks first for the keyword.50
🚧Experiencing a 500 error?

If you're requesting data for a keyword not currently available in AppTweak's database, you may encounter a timeout resulting in a 500 error. We suggest retrying the request a couple of times. Our team is actively working to optimize this behavior to minimize disruptions.

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

Updated 2 days ago

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

Updated 2 days ago