API Reference
My API token 🔑

App Reviews Displayed

get
https://public-api.apptweak.com/api/public/store/apps/reviews/top-displayed.json

Get the top displayed reviews entries about a specific app on the App Store or Google Play in the selected country and based on the given sort parameter.

Price

DatapointDescriptionCredits/review
reviewreview object containing the review body, review ID, author and more.1
📘Missing App Reviews?

Are you not seeing your app reviews? It's probably because the app is not followed and we haven't fetched data for it. You should make sure to follow the app through our ASO tool to ensure its data is fetched daily.

Query Params
string
required

Comma-separated list of app IDs (max 5). How to find App IDs?

string
enum
required

The criteria by which reviews are sorted. Mandatory: the call fails without it, and the value shown is a sample. Android does not support most_critical.

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:
int32
Defaults to 100

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

int32
Defaults to 0

Index offset to apply to the reviews. Defaults to 0.

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 4 days ago

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

Updated 4 days ago