API reference · DataForSEO
dataforseo/v3/serp/baidu/organic/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/serp/baidu/organic/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 fieldall %## will be decoded (plus character ‘+’ will be decoded to a space character)if you need to use the “%” character for ... |
os | string | Optional | device operating systemoptional fieldif you specify desktop in the device field, choose from the following values: windows, macosdefault value: windowsif you specify mobile in the device field, choose... |
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 in SERPdefault value: 10max value: 700Your account will be billed per each SERP containing up to 10 results; Setting depth above 10 may result in additiona... |
device | string | Optional | device typeoptional fieldreturn results for a specific device typecan take the values: desktop, mobile, tabletdefault value: desktop |
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_nameyou can receive the list of available languages of the search engine with their language_code by making a separate request t... |
language_name | string | Optional | full name of search engine languagerequired field if you don't specify language_codeyou can receive the list of available languages of the search engine with their language_name by making a separate r... |
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 ... |
postback_data | string | Optional | postback_url datatyperequired field if you specify postback_urlcorresponds to the datatype that will be sent to your serverpossible values:regular, html |
get_website_url | boolean | Optional | include direct URL for each ranked resultoptional fieldif set to true, the returned results will contain direct URLs of the ranked websitesby default, the URLs in Baidu results are encoded by the sear... |
max_crawl_pages | integer | Optional | page crawl limitoptional fieldnumber of search results pages to crawldefault value: 1max value: 100Note: 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... |
stop_crawl_on_match | array | Optional | array of targets to stop crawlingoptional fieldspecified as an array of target objectseach target object consists of one match_type field and one match_value fieldyou can specify up to 10 target objec... |
match_type | string | Optional | target match typerequired field if stop_crawl_on_match is specifiedtype of match for the match_valuepossible values: domain – specific domain or subdomainwith_subdomains – main domain and subdomainswi... |
match_value | string | Optional | target domain, subdomain, or wildcard valuerequired field if stop_crawl_on_match is specifiedspecify a target domain, subdomain, or wildcard value;Note: domain or subdomain must be specified without a... |
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/serp/baidu/organic/live/advanced",
"prompt": "a beautiful sunset over mountains"
}'