App Store

App Store Reviews

User reviews for an App Store app — title, text, rating and version.

GET/v1/app-store/reviews10 creditsheavyqueue only

Calling this endpoint

The source behind this endpoint answers from a queue, and that queue outlives an HTTP request — so there is no live call to make. Queue it as a task and poll for the result; /v1/app-store/reviews itself answers 400 async_only.

curl --request POST 'https://data-api.roketfy.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "app-store",
  "endpoint": "reviews",
  "params": {
    "app_id": "<app_id>"
  }
}'

See batch tasks for the full lifecycle.

Parameters

Name	Type	Required	Description
app_id	string	required	App Store app id — the digits after "id" in the app URL, e.g. "835599320".
depth	number	optional	Reviews to return, 1-500. Default 25. Billed per 25.
sort_by	string	optional	Review ordering. Default most_helpful. One of: most_recent, most_helpful.
location_name	string	optional	Full location name, e.g. "Istanbul,Turkey". Either this or location_code.
location_code	number	optional	Numeric location code. Either this or location_name.
language_code	string	optional	Language code, e.g. "tr". Either this or language_name.
language_name	string	optional	Full language name, e.g. "Turkish". Either this or language_code.
task_id	string	optional	Collect an upstream task that timed out earlier instead of starting a new one. Pass the `task_id` from the failed task's error.

MCP

Available to AI agents as the tool app_store_reviews, with the same parameters and the same credit cost. The tool queues a task and returns its id, like the HTTP flow above.

Calling this endpoint

Parameters

Request

MCP