API reference · DataForSEO
dataforseo/v3/merchant/google/products/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/merchant/google/products/live/advanced01
Input Schema
19 parameters · 1 required · 18 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Required | keywordrequired fieldyou can specify up to 700 characters in the keyword filedall %## will be decoded (plus character ‘+’ will be decoded to a space character)if you need to use the “%” character for ... |
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... |
url | string | Optional | direct URL of the search queryoptional fieldyou can specify a direct URL and we will sort it out to the necessary fields |
depth | integer | Optional | parsing depthoptional fieldnumber of results to be retrieved from Google Shopping SERPdefault value: 40max value: 120Your account will be billed per each SERP containing up to 40 results; Setting dept... |
sort_by | string | Optional | results sorting rulesoptional fieldthe following sorting rules are supported:review_score, price_low_to_high, price_high_to_lowexample:sort_by:"review_score"Note: if you specify sort_by, the search_pa... |
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... |
price_max | integer | Optional | maximum product priceoptional fieldmaximum price of the returned products listed on Google Shopping for the specified queryexample:100Note: if you specify price_max, the search_param parameter will be... |
price_min | integer | Optional | minimum product priceoptional fieldminimum price of the returned products listed on Google Shopping for the specified queryexample:5Note: if you specify price_min, the search_param parameter will be i... |
se_domain | string | Optional | search engine domainoptional fieldwe choose the relevant search engine domain automatically according to the location and language you specifyhowever, you can set a custom search engine domain in this... |
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’ ... |
search_param | string | Optional | additional parameters of the search queryoptional fieldyou can use the following search URL parameters for customizing the search;example:&tbs=ppr_min:45 – search for products that cost more than 45 U... |
language_code | string | Optional | 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 Google Shopping languages with their l... |
language_name | string | Optional | full name of the 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 Google Shopping languages ... |
location_code | integer | Optional | 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 the list of av... |
location_name | string | Optional | full name of the 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 receive th... |
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 |
max_crawl_pages | integer | Optional | page crawl limitoptional fieldnumber of search results pages to crawlmax value: 7Note: the max_crawl_pages and depth parameters complement each other;learn more at our help center |
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/merchant/google/products/live/advanced",
"prompt": "a beautiful sunset over mountains"
}'