Retrieve Baidu search results and suggestions based on a query. Useful for keyword research, SEO analysis, understanding search trends in the Chinese market, and gaining insights into user intent on Baidu.

If you already know that you want to use Baidu Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Baidu Search
Scraper	baidu_search
Engine	baidu_search
Website	Baidu
Website URL	Baidu.com
Output Format	json
Version	1.0.0
Parameter Count	11
Parameter Groups	Advanced Parameters (3), Search Query (1), Localization (1), Pagination (2), Advanced Filters (3), Request Controls (1)

Request Example

This is the real request body used to validate baidu_search during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"baidu_search","q":"OpenAI"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:18:45 UTC",
    "id": "01KMMKJDW2M51TSH7VW5SPFC4P",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKJDW2M51TSH7VW5SPFC4P.json",
    "processed_at": "2026-03-26 08:18:45 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKJDW2M51TSH7VW5SPFC4P.html",
    "status": "completed",
    "total_time_taken": 16
  },
  "search_parameters": {
    "engine": "baidu_search",
    "q": "OpenAI"
  },
  "total_credits_used": 1,
  "organic_results": [
    {
      "link": "http://www.baidu.com/link?url=PEXVzOFRCnv_69F41bDw04tmdiWvcUoI_yKmlKAwNYNR4wTgkm8xkY1n01ye1bbN",
      "snippet": "我们的研究研究索引研究概览研究驻留openai for science经济研究最新进展gpt-5.3 instantgpt-5.3-codexgpt-5codex安全安全措施安全与隐私信任与透明度chatgpt探索chatgpt(在新窗口中打开)business 版enterprise 版education 版定价(在新窗口中打开)下载(在新窗口中打开)sorasora 概览功能定价sora 登录(在新窗口中打开)api...",
      "title": "openai’s chatgpt"
    },
    {
      "_note": "5 more items omitted"
    }
  ],
  "related_searches": [
    {
      "link": "https://www.baidu.com/s?wd=openai%E4%BB%80%E4%B9%88%E6%84%8F%E6%80%9D&rsf=101631101&rsp=0&f=1&rs_src=0&rsv_pq=b87a276000285c7a&rsv_t=f53dKr1smn8aaWf2abFPuVrXgqr63GFr6DQjmBajthkONjjGV4eng9OiXO0&rsv_dl=brs_28338_1",
      "query": "openai什么意思"
    },
    {
      "_note": "9 more items omitted"
    }
  ],
  "top_searches": [
    {
      "link": "https://www.baidu.com/s?wd=%E5%9B%9B%E8%B5%B4%E9%9B%84%E5%AE%89%20%E5%AF%B9%E2%80%9C%E6%9C%AA%E6%9D%A5%E4%B9%8B%E5%9F%8E%E2%80%9D%E5%86%8D%E9%83%A8%E7%BD%B2&usm=4&ie=utf-8&rsv_pq=b87a276000285c7a&oq=OpenAI&rsv_t=a7b9mVcV... [truncated, 397 chars]",
      "text": "四赴雄安 对“未来之城”再部署"
    },
    {
      "_note": "30 more items omitted"
    }
  ]
}

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
q	string	Search Query	The keyword or phrase you want this search engine to look up.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Advanced Parameters

Field	Type	Required	Description
f	string	No	Originating Search Type.
bs	string	No	Previous Search Query.
oq	string	No	Original Search Query.

Search Query

Field	Type	Required	Description
q	string	Yes	The keyword or phrase you want this search engine to look up.

Localization

Field	Type	Required	Description
ct	number	No	Choose Language.

Additional Constraints

• ct：Default: 1；Options: 3 options. Examples: 1, 2, 3

Pagination

Field	Type	Required	Description
pn	string	No	Result Offset.
rn	string	No	Number of Results.

Advanced Filters

Field	Type	Required	Description
q5	string	No	Search Type.
q6	string	No	Search Type.
gpc	string	No	Time Period for Results.

Request Controls

Field	Type	Required	Description
no_cache	boolean	No	Skip cached results and force a fresh fetch.

Additional Constraints

• no_cache：Default: false

Previous pageGoogle Patents Detail

Next pageBing Reverse Image Search