API reference · DataForSEO

dataforseo/v3/merchant/google/sellers/live/advanced

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDdataforseo/v3/merchant/google/sellers/live/advanced

Input Schema

18 parameters · 0 required · 18 optional

Parameter	Type	Required	Description
`gid`	string	Optional	global product identifier on Google Shoppingrequired field if product_id or data_docid is not specifiedwe recommend specifying gid together with product_id and data_docid for optimal results;you can g...
`pvf`	string	Optional	product variant filter on Google Shoppingoptional fieldparameter in Google Shopping URL, setting optional product variant filtration;example:Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpem...
`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 results to be retrieved from Google Shopping SERPdefault value: 10max value: 200your account will be billed per each SERP containing up to 10 results; setting dept...
`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...
`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...
`data_docid`	string	Optional	unique identifier of the SERP data elementrequired field if product_id or gid is not specifiedwe recommend specifying data_docid together with product_id and gid for optimal results;you can get this v...
`product_id`	string	Optional	unique product identifier on Google Shoppingrequired field if data_docid or gid is not specifiedwe recommend specifying product_id together with data_docid and gid for optimal results;you can get 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’ ...
`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	—
`get_shops_on_google`	boolean	Optional	include "buy on Google" shopsoptional fieldif set to true, the response will contain the list of sellers that allow to purchase a given product directly on GoogleNote: if set to true, the cost of a ta...
`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...
`additional_specifications`	object	Optional	object containing additional url parametersyou can get additional information about the product by using the "additional_specifications object, which you can get by making a separate request to the Go...

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

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/sellers/live/advanced",
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Merchant Google Sellers