Skip to main content
GET
Baidu Autocomplete
Baidu’s search-box suggestions for a partial term — what the dropdown on baidu.com would show as you type. At 1 credit this is the cheapest call in the Baidu API and the fastest way to turn a seed term into real Chinese queries people actually search. Credits: 1

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
required
Partial search term, e.g. 咖啡 or coff. URL-encode as UTF-8.

Response

string
Echo of the partial term.
Suggestion[]
Baidu’s suggestions, in Baidu’s own order (most likely first).

Example

Response

Keyword expansion

Autocomplete is the cheap half of a two-step keyword workflow:
  1. Call /autocomplete on the seed term (1 credit) to get Baidu’s real query variants.
  2. Call /search on each variant (5 credits) and merge results on url.
That covers a topic far more broadly than paging one query toward its page-76 wall, for fewer credits. The related_searches block on every /search response feeds the same loop for free.
Suggestions are prefix-driven, so the seed’s ending changes the whole set: 咖啡 returns brand and bean queries, while 咖啡机 returns machine queries. Fan out over a few seeds rather than trusting one.
Latin input works — coff returns suggestions — but Baidu’s suggestion index is overwhelmingly Chinese, so Chinese seeds return far more.

Errors