New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

Baidu Scraper API: 1 endpoint, structured JSON

Baidu search results, ranked and typed: title, link, displayed link, snippet and position for any Chinese or English query, with an optional date range. Public data only.

Copy for your AI agent
1Baidu endpoint
1credit per successful call
0credits for a failed call
1need no Baidu login
Quick answerScrapier returns typed JSON from 1 Baidu endpoint: organic search results with answer boxes and date filters. Public data only and no proxies; no Baidu login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026
Endpoints

What data can I extract with Baidu Scraper?

One endpoint covers Baidu web search. Send one keyword and get clean JSON back for 1 credit per successful call.

Playground

Try Baidu Scraper Live

Pick an endpoint, fill in the input and press Run. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

BaiduBaidu SearchLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data
Pricing

How much will scraping Baidu cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Baidu calls a month is $299.

See all plans →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$1.93
Pro$7950,000$1.58
Scale$299250,000$1.20
How to

How do I use Baidu Scraper?

Built to be easy to start with, even if you've never scraped a search engine. Here's how to get Baidu results in a few minutes:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Pick the endpoint for your databaidu-search returns the organic results, and any answer box, for one query.
  3. Add your inputOne keyword or phrase in query per call, in Chinese or English.
  4. Page through the resultsList endpoints return next_cursor; pass it back as cursor for the next page. null means the last page. The cursor carries the original query forward.
  5. Filter by dateSend days for the last N days, or time_period with a start and end date.
  6. Run the requestOne GET with your key in the X-API-Key header, or ask your AI agent over MCP.
  7. Save the resultsJSON from the API: store it as is, or flatten it to CSV in a few lines.
Input

Input

Every endpoint takes the same kind of input.

1

By keyword

You don't know the items yet: find them with a keyword.

Baidu Search机器学习
Best fordiscovery · plain text, "travel" not "#travel"
Example requests
// GET /api/v2/baidu-search/
{
  "query": "机器学习",
  "days": "0"
}
Send thisParameterAnd you can get
Keyword or phrasequeryRanked organic results with title, link, displayed link and snippet
Date filterdays · time_periodOnly results from the last N days or a date range
CursorcursorThe next page of the same query
Raw moderaw_dataThe raw upstream payload instead of the formatted results

Optional on list endpoints: cursor (pass back next_cursor for the next page). Auth is one header: X-API-Key. Send parameters in the query string (GET) or as a JSON body (POST).

Output

Output

The one thing to know: each data type has its own shape. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/baidu-search/?query=机器学习
// one item of data.organic_results · catalog sample
{
  "title": "什么是机器学习? - 百度百科",
  "link": "https://baike.baidu.com/item/%E6%9C%BA%E5%99%A8%E5%AD%A6%E4%B9%A0",
  "displayed_link": "baike.baidu.com",
  "snippet": "机器学习是人工智能的一个分支,它使计算机能够通过数据学习,而不是通过明确的编程指令...",
  "position": 1,
  "keyword": "机器学习"
}

Every response is {"success": true, "data": {…}}: your input echoed back, the result under its own key (profile, posts, comments…) and next_cursor for the next page.

Use cases

What can you do with Baidu data?

Public Baidu results power SEO for the Chinese market, brand monitoring and market research. Here are three common jobs and the Baidu scraper endpoint each one uses.

01

Baidu rank tracking

Check where your Chinese pages rank on Baidu for each target keyword. Store position and link per day to see which pages climb or drop, and which competitors take the top spots.

  1. 1search
  2. Rank history
DailySheets, dashboard
02

Brand and news monitoring

Search your brand and product names with days set to 1 or 7 to see new pages about you. Feed new links to your monitoring dashboard so the team can review them.

  1. 1search
  2. Mention feed
DailyDashboard, CRM
03

China market research

Read the titles, snippets and answer boxes that rank for a category before entering the market. Group results by displayed_link to see which sites own the topic.

  1. 1search
  2. Market brief
Per projectDocs, CSV
Features

Features

Baidu Scraper fetches clean, structured Baidu search results at the lowest per-call cost in the catalog: built for China SEO, monitoring and AI agents.

Live data, every call

Each request reads Baidu at call time, so results reflect the ranking at that moment.

Typed, consistent JSON

Same field names on every call, numbers as numbers, ready for code, sheets or an LLM.

Lists, page by page

Results come a page at a time with next_cursor; run up to 3 requests in parallel per key.

One endpoint, one shape

Every organic result has the same fields: title, link, displayed link, snippet, position and keyword.

MCP-ready for AI agents

The Scrapier MCP server reaches every Baidu endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

No proxies to manage

Public data only. No Baidu account or login; Scrapier routes the request for you.

Maintained for you

When Baidu changes its pages, Scrapier updates the scraper; your field names stay the same.

Pay per successful call

1 credit per call, however many results the page holds. Failed calls are never billed.

Why Scrapier

Why choose this Baidu Scraper?

Baidu result pages are built for people, not code: HTML, ads and answer boxes mixed together. Scrapier reads the public Baidu result pages with one API key and returns typed JSON, at a price you know before the call runs.

0Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

$1.20Per 1,000 calls on Scale

At 1 credit a call. Flat per-call pricing, no compute units or bandwidth to estimate.

0Setup steps on Baidu

No Baidu account, developer registration or HTML parser to set up.

1 keyFor 35 platforms

The same key and JSON envelope cover Google, Amazon, TikTok, YouTube and more.

FeatureScrapier Baidu ScraperOfficial APIDIY scraper
Whose dataPublic Baidu resultsCheck Baidu's current developer termsPublic Baidu results
SetupOne API keyBaidu developer accountProxies, browsers, parsers
MaintenanceHandled by ScrapierDepends on the productBreaks on layout changes
CostFrom $1.20 per 1,000 callsDepends on the productServers, proxies and engineering time
AI agentsMCP server includedBuild your ownBuild your own
FAQ

Frequently asked questions

What data does the Baidu scraper return?

Organic Baidu results for one query, under organic_results. Each result has title, link, displayed_link, snippet, position and the keyword you sent. The response also has answer_box when Baidu shows one, and next_cursor for the next page.

Can I search Baidu in Chinese?

Yes. Send the query exactly as a Chinese user would type it, for example 机器学习. English queries work too. The response echoes your query so you can match results to keywords in your own tables.

Can I filter Baidu results by date?

Yes. Send days for the last N days, for example days=7. Or send time_period as a start_date and end_date pair. When days is above 0 it overrides time_period.

How do I get more than one page of Baidu results?

Read next_cursor from the response and send it back as cursor. Each page is one call at 1 credit. The cursor carries the original query forward, and null means you have reached the last page.

Can I send several keywords in one call?

No. Each call takes one keyword or phrase in query. To track a list, loop over it and run up to 3 calls in parallel per key; failed or throttled calls cost nothing, so retries are free.

Do I need a Baidu account?

No. Scrapier reads public Baidu result pages for you, so there is no Baidu account or login to create. You only need a Scrapier API key, sent in the X-API-Key header.

How much does the Baidu scraper cost?

Baidu Search costs 1 credit per successful call, however many results the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

Can I get the raw Baidu response?

Yes. Set raw_data to true and the response carries the raw upstream payload under raw_responses instead of the formatted results. Pagination with cursor and next_cursor works the same way in both modes.

Is it legal to scrape Baidu?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible Baidu data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use and check Baidu's terms.

Can I connect Baidu data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON under data.

Can I get Baidu data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Baidu endpoint with search_endpoints and calls it with run_scrape, in Claude Code, Cursor or Windsurf.

Baidu Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

What are the Baidu scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

How do I scrape Baidu with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/baidu-search/", headers={"X-API-Key": key}, params={"query": "机器学习"}, timeout=210). The response is JSON, so read r.json()["data"]["organic_results"] directly; there is no HTML to parse. Each call returns one page.

Get started

Start pulling Baidu data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.