Application reviews

Returns application reviews
Results is paginated by 100 records

GET /api/app-reviews

Query parameters

Mandatory

  • storetype - store type (appstore or googleplay)

  • storeid - store id of app (for example com.google.android.apps.maps or 585027354)

  • country - country ISO code (ex.: US, RU, GB etc.)

Optional

  • timestamp (default: now) - timestamp of search results in ISO format (YYYY-MM-DDThh:mmTZD, ex.: 2017-07-16T19:20%2B03:00) Note that plus sign is replaced with %2B

  • page (default: 1) - results page

Example request

GET /api/app-reviews?country=US&storetype=appstore&storeid=1140806270

If we have all required information for this request, you will get following response:

Status: 200 OK

{
    "id": <string>,  // request id for technical support purposes
    "data": {
        "timestamp": <string>,  // ISO format timestamp of results,
        "storetype": <string>,  // same as specified in query params,
        "storeid": <string>,  // same as specified in query params,
        "country": <string>,  // same as specified in query params,
        "results" {
            "page": <integer>,  // current page of results,
            "reviews": [{
                "title": <string>,  // appstore only
                "content": <string>,
                "rating": <integer>,
                "author": {
                    "name": <string>,
                    "id": <string>  // user id in store
                },
                "updated": <string>,  // ISO format
                "developer_content": <string>,
                "developer_updated": <string>,  // ISO format
                "language": <string>
            }]
        }
    }
}

If we need to download some additional data from store’s servers, you will get following response:

Status: 202 Accepted

{
    "key": <string>,  //request key for technical support purposes
    "detail": "Result is preparing, try in 30 seconds later"
}

So, try in 30 seconds later and if response will be ready you will get full data.


If store’s servers got no required data or we don’t have required data, you will get following response:

Status: 204 No Content

You may try later to get expected data.