API reference · DataForSEO
dataforseo/v3/app_data/google/app_reviews/live/advanced
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
dataforseo/v3/app_data/google/app_reviews/live/advanced01
Input Schema
13 parameters · 1 required · 12 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | string | Required | id of the apprequired fieldID of the mobile application on Google Play;you can find the ID in the URL of every app listed on Google Play;example:https://play.google.com/store/apps/details?id=org.teleg... |
tag | string | Optional | user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object... |
depth | integer | Optional | parsing depthoptional fieldnumber of reviews to be returned in the API response;we strongly recommend setting the parsing depth in the multiples of 150, because our system processes 150 reviews in a r... |
rating | integer | Optional | filter reviews by ratingoptional fieldyou can use this field to filter the results;possible types of filtering:5 — return reviews with five-star rating only;4 — return reviews with four-star rating on... |
sort_by | string | Optional | results sorting parametersoptional fieldyou can use this field to sort the results;possible types of sorting:newest — sort by the most recent reviews;most_relevant — sort by the most relevant reviews;... |
priority | integer | Optional | task priorityoptional fieldcan take the following values:1 – normal execution priority (set by default)2 – high execution priorityYou will be additionally charged for the tasks with high execution pri... |
pingback_url | string | Optional | notification URL of a completed taskoptional fieldwhen a task is completed we will notify you by GET request sent to the URL you have specifiedyou can use the ‘$id’ string as a $id variable and ‘$tag’... |
postback_url | string | Optional | URL for sending task resultsoptional fieldonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specifiedyou can use the ‘$id’ ... |
language_code | string | Optional | search engine language coderequired field if you don't specify language_nameif you use this field, you don't need to specify language_nameyou can receive the list of available languages with their lan... |
language_name | string | Optional | full name of search engine languagerequired field if you don't specify language_codeif you use this field, you don't need to specify language_codeyou can receive the list of available languages with l... |
location_code | integer | Optional | search engine location coderequired field if you don't specify location_nameif you use this field, you don't need to specify location_nameyou can receive the list of available locations of the search ... |
location_name | string | Optional | full name of search engine locationrequired field if you don't specify location_codeif you use this field, you don't need to specify location_codeyou can receive the list of available locations of the... |
postback_data | string | Optional | postback_url datatyperequired field if you specify postback_urlcorresponds to the datatype that will be sent to your serverpossible values:advanced, html |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "dataforseo/v3/app_data/google/app_reviews/live/advanced",
"prompt": "a beautiful sunset over mountains"
}'