API reference · DataForSEO
dataforseo/v3/business_data/google/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/business_data/google/reviews/live/advanced01
Input Schema
14 parameters · 0 required · 14 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
cid | string | Optional | unique, google-defined id of the business entityrequired field if you don't specify keyword or place_idexample:194604053573767737learn more about the identifier in this help center article |
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 in SERPwe strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten reviews in a rowdefault value: 10maximum ... |
keyword | string | Optional | keywordrequired field if you don't specify cid or place_idthe keyword you specify should indicate the name of the local establishment;you can specify up to 700 characters in the keyword filed;all %## ... |
sort_by | string | Optional | results sorting parametersoptional fieldyou can use this field to sort the resultspossible types of sorting:newest – sort by newest firsthighest_rating – sort by highest ratinglowest_rating – sort by ... |
place_id | string | Optional | identifier of the business entity in Google Mapsrequired field if you don't specify keyword or cidexample:GhIJQWDl0CIeQUARxks3icF8U8Alearn more about the identifier in this help center article |
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_name_or location_coordinateif you use this field, you don't need to specify location_name or location_coordinateyou can receive ... |
location_name | string | Optional | full name of search engine locationrequired field if you don't specify location_code or location_coordinateif you use this field, you don't need to specify location_code or location_coordinateyou can ... |
location_coordinate | string | Optional | GPS coordinates of a locationrequired field if you don't specify location_name_or location_codeif you use this field, you don't need to specify location_name or location_codelocation_coordinate parame... |
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/business_data/google/reviews/live/advanced",
"prompt": "a beautiful sunset over mountains"
}'