JustSERPDocs
Apple

Apple App Store Reviews

One page (50) of an app's customer reviews, from Apple's customer-reviews feed, answered as the document with `reviews`.

GET
/v1/apple/app-store/reviews

One page (50) of an app's customer reviews, from Apple's customer-reviews feed, answered as the document with reviews. The feed ends at page 10. The reviews are those of the storefront in country; an app with none there answers reviews: [].

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
product_id*string

The number after /id in the app's App Store address.

Match^[0-9]+$
country?string

The storefront whose reviews are shown.

Match^[A-Za-z]{2}$
Default"us"
page?integer

A page is 50 reviews.

Range1 <= value <= 10
Default1
sort_by?string

Order.

Default"most_recent"
Value in"most_recent""most_helpful"

Response Body

The reviews, as the document. When the feed could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
reviews?array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/apple/app-store/reviews?product_id=1668000334&sort_by=most_helpful'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "reviews": [    {      "id": "string",      "title": "string",      "text": "string",      "rating": 0,      "review_date": "string",      "date": "string",      "version": "string",      "helpful_votes": 0,      "total_votes": 0,      "author": {        "name": "string",        "id": "string"      }    }  ]}

Apple App Store Product GET

One app's page from apps.apple.com, answered as the document: `app_details`, `version_history`, `reviews` (the feed's newest 50), `app_privacy`, `information`, `supports`, `featured_in` and `related_apps`.

Apple App Store Top Charts GET

The free or paid chart of a storefront, from Apple's chart feed, answered as the document with `top_charts`.