🚀 Baidu Search Scraper | Baidu API for SERP Data | 百度搜索爬虫 (百度)

The most efficient, reliable, and developer-friendly Baidu search scraper for Apify platform

适用于 Apify 平台的最高效、最可靠、对开发者最友好的百度搜索爬虫

This Baidu API scrapes Baidu (百度) search results as clean, structured JSON: organic results, answer boxes, related videos, related searches, and top searches. No Chinese phone number or local account required.

---

🌟 Why Choose This Scraper?

The Baidu Search data scraper delivers enterprise-grade performance with these advanced capabilities:

Performance & Reliability: Built optimized for high-throughput scraping with intelligent rate limiting and pagination handling.

Cost-Effective: Provides consistent, reliable results with intelligent pagination management to optimize API usage.

Lightning-Fast Search & Retrieval: Search any keyword across Baidu with blazing-fast performance. Retrieve comprehensive results in seconds, not minutes, with intelligent caching and optimization.

Precision Targeting & Advanced Filtering: Pinpoint exact search parameters with device targeting, localization support, and time period filtering. Get precisely the search data you need, when you need it.

Rich, Structured Data Extraction: Extract complete search information, including organic results, answer boxes, related videos, people also search for, related searches, and top searches. Our advanced parsing ensures you get clean, structured data ready for immediate use.

Enterprise-Grade Configuration & Flexibility: Built for developers and businesses who demand reliability. Highly configurable with intuitive controls, comprehensive error handling, and robust logging. Focus on your business logic while we handle the complexity of search scraping.

No Hidden Costs or Rental Fees: We do not charge monthly rentals, our scraper operates on a pay-per-use model. Scale up or down based on your actual needs without being locked into expensive subscriptions.

---

🌟 为什么选择本爬虫？

百度搜索数据爬虫以企业级性能为您提供以下高级功能：

性能与可靠性：针对高吞吐量爬取进行了优化，具备智能限速和分页处理能力。

高性价比：通过智能分页管理优化 API 使用，提供稳定可靠的结果。

极速搜索与检索：以极快的速度在百度上搜索任意关键词。在秒级时间内获取全面结果，无需等待数分钟。

精准定向与高级筛选：通过设备定向、语言本地化支持和时间段过滤，精确锁定搜索参数，随时获取您所需的精准搜索数据。

丰富的结构化数据提取：提取完整的搜索信息，包括自然结果、知识框、相关视频、相关搜索建议、相关搜索词和热门搜索。我们的高级解析确保您获得干净、结构化的即用数据。

企业级配置与灵活性：专为追求可靠性的开发者和企业打造。高度可配置，操控直观，具备完善的错误处理和健壮的日志记录。专注于您的业务逻辑，让我们处理搜索爬取的复杂性。

无隐性费用或租用费：我们不收取月租费，爬虫采用按需付费模式。根据实际需求弹性伸缩，无需锁定在昂贵的订阅套餐中。

---

📦 What You Get | 返回内容

Every run returns clean, structured JSON you can load straight into a database, spreadsheet, or AI agent:

• Organic results with title, link, snippet, position, displayed_link, and rich snippets
• Answer box direct-answer results (知识框)
• Related videos surfaced in the SERP (相关视频)
• People also search for and related searches suggestions (相关搜索)
• Top searches trending on Baidu (热门搜索)
• Pagination and search metadata so you know exactly what was fetched

Results are pushed one page per dataset item, so billing and downstream processing stay predictable.

返回内容包括自然结果、知识框、相关视频、相关搜索、热门搜索，以及分页与搜索元数据。

---

🚀 Features | 功能特性

Core Capabilities

• Advanced Search: Support for complex queries with device targeting, localization, and time period filtering
• Intelligent Pagination: Automatic handling of Baidu search pagination with configurable limits
• Device Targeting: Support for desktop and mobile search results
• Multi-Language: Support for international search markets with localization options
• Time Period Filtering: Advanced time-based result filtering using Unix timestamps

核心功能

• 高级搜索：支持复杂查询，具备设备定向、语言本地化和时间段过滤功能
• 智能分页：自动处理百度搜索分页，支持可配置的分页限制
• 设备定向：支持桌面端和移动端搜索结果
• 多语言支持：支持国际搜索市场的语言本地化选项
• 时间段过滤：使用 Unix 时间戳进行高级时间范围结果过滤

Data Quality

• Clean Output: Automatic structured data metadata for clean, production-ready data
• Structured Results: Consistent JSON structure across all search results
• Comprehensive Fields: Organic results, answer boxes, related videos, people also search for, and more
• Metadata Tracking: Page-level analytics and search performance metrics
• Per-Page Billing: Results are pushed as separate dataset items for accurate billing

数据质量

• 清洁输出：自动生成结构化数据元数据，输出生产就绪的干净数据
• 结构化结果：所有搜索结果采用一致的 JSON 结构
• 全面字段：自然结果、知识框、相关视频、相关搜索建议等
• 元数据追踪：页面级分析和搜索性能指标
• 按页计费：结果作为独立数据集条目推送，实现精准计费

---

📖 Usage Examples | 使用示例

Basic Search Example

Search for "python tutorial" on desktop with default settings.

{
  "query": "python tutorial",
  "device": "desktop"
}

基本搜索示例

在桌面端搜索"Python教程"，使用默认设置。

{
  "query": "Python教程",
  "device": "desktop"
}

---

Advanced Search Example

Search for "machine learning" on desktop with Chinese localization, time period filtering, and pagination limits.

{
  "query": "machine learning",
  "device": "desktop",
  "localization": 2,
  "page": 1,
  "num_results": 20,
  "time_period": "stf=1755138395,1755743195|stftype=1",
  "max_pagination": 3
}

高级搜索示例

在桌面端搜索"机器学习"，并启用简体中文本地化、时间段过滤和分页限制。

{
  "query": "机器学习",
  "device": "desktop",
  "localization": 2,
  "page": 1,
  "num_results": 20,
  "time_period": "stf=1755138395,1755743195|stftype=1",
  "max_pagination": 3
}

参数说明 (Parameter Notes):

• query - 搜索词 (search term)
• device - 设备类型：desktop(桌面) / mobile(手机) / tablet(平板)
• localization - 语言：1=全部, 2=简体中文, 3=繁体中文
• page - 起始页码 (starting page number)
• num_results - 每页结果数，最多50条 (results per page, max 50)
• time_period - 时间范围过滤，使用Unix时间戳格式 (date range filter using Unix timestamps)
• max_pagination - 最大获取页数，0表示不限制 (max pages to fetch, 0 = unlimited)

---

🔍 Input References | 输入参数说明

Input Parameters

Parameter	Type	Required	Default	Description
query	str	✅	"python tutorial"	Search query
device	str	❌	"desktop"	Device type ("desktop" or "mobile")
localization	Optional[int]	❌	None	Localization code (e.g., 2 for Simplified Chinese)
page	int	❌	1	Starting page number
num_results	int	❌	10	Number of results per page
time_period	Optional[str]	❌	None	Time period filter format (stf=start_timestamp,end_timestamp
max_pagination	Optional[int]	❌	3	Maximum pages to fetch (0 = no limit)
output_file	Optional[str]	❌	None	Custom output filename

输入参数

参数名	类型	必填	默认值	说明
query	str	✅	"python tutorial"	搜索词
device	str	❌	"desktop"	设备类型（"desktop" 桌面 / "mobile" 手机）
localization	Optional[int]	❌	None	语言本地化代码（例如：2 表示简体中文）
page	int	❌	1	起始页码
num_results	int	❌	10	每页结果数量
time_period	Optional[str]	❌	None	时间段过滤，格式：stf=起始时间戳,结束时间戳|stftype=1。例如 stf=1755138395,1755743195|stftype=1 表示仅返回最近7天的结果。
max_pagination	Optional[int]	❌	3	最大获取页数（0 = 不限制）
output_file	Optional[str]	❌	None	自定义输出文件名

---

📊 Output Format | 输出格式

Search Result Structure | 搜索结果结构

{
  "query": "machine learning",
  "device": "desktop",
  "localization": 2,
  "page": 1,
  "num_results": 20,
  "filter_results": null,
  "time_period": "stf=1755138395,1755743195|stftype=1",
  "max_pagination": 3,
  "total_results_found": 150,
  "pages_processed": 3,
  "search_metadata": {
    "query": "machine learning",
    "device": "desktop",
    "localization": 2,
    "page": 1,
    "num_results": 20,
    "filter_results": null,
    "time_period": "stf=1755138395,1755743195|stftype=1",
    "max_pagination": 3,
    "pagination_limit_reached": false
  },
  "pagination_info": {
    "total_pages": 3,
    "current_page": 1,
    "max_pagination_set": 3,
    "pagination_stopped_by_limit": false
  },
  "organic_results": [
    {
      "title": "Machine Learning Tutorial",
      "link": "https://example.com/ml-tutorial",
      "snippet": "Learn machine learning fundamentals...",
      "position": 1,
      "displayed_link": "example.com",
      "thumbnail": "https://thumbnail.url",
      "rich_snippet": "Rich snippet content...",
      "sitelinks": [...],
      "related_videos": [...]
    }
  ],
  "answer_box": [...],
  "related_videos": [...],
  "people_also_search_for": [...],
  "related_searches": [...],
  "top_searches": [...],
  "results_by_page": {
    "1": {
      "organic_results": [...],
      "answer_box": [...],
      "related_videos": [...],
      "people_also_search_for": [...],
      "related_searches": [...],
      "top_searches": [...]
    }
  }
}

中文字段说明 (Field Descriptions in Chinese):

• query - 搜索词
• device - 设备类型
• localization - 语言本地化代码
• total_results_found - 找到的结果总数
• pages_processed - 已处理的页数
• search_metadata - 搜索元数据（包含运行配置摘要）
• pagination_info - 分页信息（总页数、当前页、是否达到限制）
• organic_results - 自然搜索结果列表（含标题、链接、摘要、位置、缩略图等）
• answer_box - 知识框直接答案结果
• related_videos - 相关视频结果
• people_also_search_for - 相关搜索建议
• related_searches - 相关搜索词
• top_searches - 热门搜索词
• results_by_page - 按页分组的结果

---

💰 Pricing | 价格说明

This actor uses pay-per-event billing - you only pay for what you use.

Event	Free Plan	Business Plan
Search initiation (per run)	$0.012	$0.010
Page of results processed (per 1,000)	$20.00	$15.00

Example cost: A 3-page search (default max_pagination) costs approximately $0.012 + (3 x $0.020) = ~$0.07 per run on the Free Plan.

Apify subscription plans (Starter, Scale/Business) offer 11-24% discounts. No monthly rental fees.

---

本爬虫采用按事件计费模式 - 您只需为实际使用付费。

计费事件	免费套餐	商业套餐
搜索启动（每次运行）	$0.012	$0.010
处理结果页（每1,000页）	$20.00	$15.00

费用示例： 默认设置下3页搜索（max_pagination 默认值）约花费 $0.012 + (3 x $0.020) = 约 $0.07/次运行（免费套餐）。

Apify 订阅套餐（Starter、Scale/Business）享受 11-24% 折扣。无月租费。

---

🤖 Use with AI Agents via MCP | 通过 MCP 与 AI 智能体集成

This actor is available through the Apify MCP server, making it directly callable by AI agents (Claude, GPT-4, and others) without any manual setup.

An AI agent can call this actor by name, pass a query, and receive structured Baidu search results directly in the conversation.

Connect via MCP (Claude Desktop / VS Code / Cursor):

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com"
    }
  }
}

Once connected, ask your AI agent: "Search Baidu for machine learning tutorials" and it will call this actor automatically.

---

本爬虫可通过 Apify MCP 服务器 使用，可直接被 AI 智能体（Claude、GPT-4 等）调用，无需任何手动配置。

AI 智能体可以按名称调用本爬虫，传入 query 参数，并在对话中直接接收结构化的百度搜索结果。

通过 MCP 连接（Claude Desktop / VS Code / Cursor）：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com"
    }
  }
}

连接后，向您的 AI 智能体提问："在百度上搜索机器学习教程"，它将自动调用本爬虫。

---

🚀 How to Get Started | 快速开始

1. Open the actor on the Apify Store
2. Click Try for free
3. Enter your search query (required - all other fields have defaults)
4. Click Start - results appear in the dataset within seconds

---

1. 在 Apify 商店打开本爬虫
2. 点击 Try for free（免费试用）
3. 输入搜索词 query（必填 - 其他字段均有默认值）
4. 点击 Start（开始） - 结果将在数秒内出现在数据集中

---

🎯 Use Cases: Baidu API for SEO, Tracking, and Research | 应用场景

The Baidu API powers a range of China-market workflows:

• China SEO and rank tracking: use the Baidu API for keyword rank tracking, watching where your brand and competitors show up in Baidu organic results over time.
• Brand and reputation monitoring: set up recurring Baidu monitoring to catch new mentions, negative results, or ranking drops for your target keywords.
• Market and competitor research: pull structured Baidu data (organic results, related searches, top searches) to size demand and study the Chinese search landscape.
• AI agents and RAG: feed live Baidu results into an LLM through the Baidu MCP integration so an agent can answer questions about the Chinese web.
• Content and localization research: harvest related and top searches to plan Chinese-language content that matches real Baidu query intent.

应用场景：百度SEO与关键词排名追踪、品牌与舆情监控、市场与竞品研究、AI 智能体检索增强（RAG），以及中文内容与本地化研究。

---

🔌 Integrations: Automate Baidu Data Collection | 集成与自动化

A single run answers one question. The real value comes from running the Baidu API on a schedule and sending the results wherever you work. See the full list of Apify platform integrations.

Tasks and schedules (recurring Baidu monitoring)

Save one task per query you want to watch (a brand term, a product name, a competitor), then attach one schedule from the Actor's Actions, then Schedule menu. One schedule can trigger many tasks at once. Useful cron strings:

• 0 7 * * *: every day at 7 AM
• 0 */6 * * *: every six hours
• 0 9 * * 1: every Monday morning

This turns the scraper into a standing Baidu rank tracker. The Check how your brand ranks on Baidu task is a ready-made starting point.

n8n

Available as an n8n community node, n8n-nodes-baidu-search-api. Build a four-step workflow: Schedule Trigger, then the Baidu node, then a Filter (for example, alert only when your domain drops out of the top 10), then a Slack or email node. It also works as an AI Agent tool inside n8n.

Make and Zapier

Connect the same output to thousands of apps with Make and Zapier: trigger on a finished run and route each result to a sheet, CRM, or chat channel.

Store the data in Supabase

Accumulate a history of rankings by writing each run into your own database. This Python snippet runs the Actor and bulk-inserts the flat organic rows into a Supabase table:

from apify_client import ApifyClient
from supabase import create_client

apify = ApifyClient("YOUR_APIFY_TOKEN")
supabase = create_client("YOUR_SUPABASE_URL", "YOUR_SUPABASE_KEY")

run = apify.actor("johnvc/Baidu-Search-Scraper").call(run_input={
    "query": "机器学习",
    "device": "desktop",
    "localization": 2,
    "max_pagination": 3,
})

rows = []
for item in apify.dataset(run["defaultDatasetId"]).iterate_items():
    for r in item.get("organic_results", []):
        rows.append({
            "query": item.get("query"),
            "position": r.get("position"),
            "title": r.get("title"),
            "link": r.get("link"),
            "snippet": r.get("snippet"),
        })

supabase.table("baidu_rankings").insert(rows).execute()

No-code alternative: in n8n, chain the Baidu node into the Supabase node and map the same fields.

MCP and AI agents

Add the Baidu API as a tool to any MCP client (Claude, Cursor, and others) through the hosted Apify MCP server. An agent can then answer questions like "What ranks on Baidu for 机器学习 this week?" live in the conversation. See the Get Baidu search results in Claude via MCP task, and connect Claude Code (free trial) as an MCP client.

Webhooks

For anything custom, add an Apify webhook on ACTOR.RUN.SUCCEEDED to push finished runs into your own endpoint.

集成方式：定时任务（百度排名监控）、n8n 社区节点、Make/Zapier、Supabase 存储、MCP 与 AI 智能体，以及 Webhooks。

---

🔗 Related Tools | 相关工具

Building cross-market search coverage? These related Actors extend the same rank-tracking workflow to other search engines:

• Naver Search API: scrape Naver, the dominant search engine in South Korea, across web, news, image, and shopping verticals.
• Yandex Search Scraper: track organic rankings on Yandex, the leading search engine in Russia and much of the CIS.
• DuckDuckGo Scraper: pull DuckDuckGo SERP rankings for privacy-focused and Western-market coverage.

For contrast, an older alternative such as this Baidu scraper exists, but it carries a 1-star rating, has no monthly active users, and ships a one-line README with no field-by-field documentation. This Baidu API is actively maintained, documented field by field, and returns clean, consistent JSON.

相关工具：Naver 搜索 API（韩国）、Yandex 搜索采集器（俄罗斯）、DuckDuckGo 采集器，覆盖多市场搜索排名监控。

---

❓ FAQ & Troubleshooting | 常见问题与故障排除

Q: Why are no results returned? Check that your query is not empty. Very niche or highly specific queries may return zero results on Baidu - try a broader term.

问：为什么没有返回结果？ 请确认 query 不为空。非常小众或过于具体的查询词可能在百度上返回零结果 - 请尝试更宽泛的词语。

---

Q: How do I get only Simplified Chinese results? Set localization to 2. Use 3 for Traditional Chinese. Leave at 1 (default) for all languages.

问：如何只获取简体中文结果？ 将 localization 设置为 2。繁体中文请使用 3。保持默认值 1 则返回所有语言的结果。

---

Q: What is the time_period format? Use Unix timestamps: stf=START_UNIX,END_UNIX|stftype=1. Most users leave this blank to get results from all dates.

问：time_period 参数的格式是什么？ 使用 Unix 时间戳格式：stf=起始时间戳,结束时间戳|stftype=1。大多数用户将此项留空以获取所有日期的结果。

---

Q: Can I get more than 10 results per page? Yes - set num_results up to 50. Increase max_pagination to fetch additional pages.

问：每页可以获取超过10条结果吗？ 可以 - 将 num_results 设置为最多50条。增大 max_pagination 值可获取更多页面。

---

Q: Why did the run exit early? If your configured spending limit is reached before all pages are processed, the actor exits gracefully to stay within budget.

问：为什么运行提前退出？ 如果在处理完所有页面之前达到了您配置的消费限额，爬虫将优雅地退出以控制在预算范围内。

---

Can I schedule this Baidu Scraper?

Yes. Any run can be automated on a schedule. Create a saved task with your query and options, then attach a schedule from the Actor's Actions, then Schedule menu. Concrete cron examples: 0 7 * * * runs daily at 7 AM, 0 */6 * * * every six hours, and 0 9 * * 1 every Monday. One schedule can trigger many tasks at once, so you can monitor dozens of keywords in parallel. See the Integrations section above for the full recurring Baidu monitoring recipe.

Should I use an API or a Web Scraper for Baidu?

Baidu has no official public search API, and third-party options are often rate limited, quota bound, and missing SERP features. This Actor gives you the same data either as a no-code web scraper you run from the dashboard or as a clean API endpoint you call yourself, with no quotas and per-page billing. Learn the difference between an API and web scraping.

Can I integrate this Baidu Scraper with other apps?

Yes. The Actor connects to almost any cloud service through Apify integrations, including Make, Zapier, and Slack, plus webhooks that fire on ACTOR.RUN.SUCCEEDED. The Integrations section above has copy-paste recipes for n8n and Supabase.

Can I use the Baidu API with the Apify API?

Yes. The Apify API gives you programmatic access to run the Actor, schedule it, and fetch datasets, and the apify-client package is available for both Python and Node.js. See the Actor's own API tab.

Can I use this Baidu Scraper through an MCP Server?

Yes. Add it as a tool to any MCP client (Claude, Cursor, and others) through the hosted Apify MCP server. The Actor-specific URL is https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper. You can connect it to Claude Code (free trial) as an MCP client. See the Apify MCP docs.

How can I track other search engines besides Baidu?

Pair this with the related Actors above to cover more markets: the Naver Search API for South Korea, the Yandex Search Scraper for Russia and the CIS, and the DuckDuckGo Scraper for privacy-focused search. Together they give you cross-engine rank tracking.

What is Baidu, and does it track searches?

Baidu is the largest search engine in China, comparable in role to Google in the West (see Baidu on Wikipedia). Like any major search engine it logs query and click activity; this Actor only reads public organic results and does not require a Baidu account or login.

How do I get a Baidu API for rank tracking?

There is no official Baidu API for search rankings, so most teams use a scraper. Run this Actor with your keywords and read the organic_results array (each item has position, title, link, and snippet) to track where a domain ranks on Baidu over time. Schedule it (see above) to build a ranking history.

---

Python Code for Scraping Baidu Search Results | 百度搜索结果爬取 Python 代码

See our complete example Python code for scraping Baidu search results.

请查看完整的百度搜索结果爬取 Python 示例代码。

Made with ❤️

Transform your search automation with the most reliable and efficient Baidu search scraper on the market.

使用市场上最可靠、最高效的百度搜索爬虫，提升您的搜索自动化能力。

---

n8n integration

Available as an n8n community node, n8n-nodes-baidu-search-api. In n8n: Settings, Community Nodes, install n8n-nodes-baidu-search-api, then use it in any workflow (it also works as an AI Agent tool).

---

Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click.

• Search Baidu by API without a Chinese number - organic Baidu results as JSON with no Chinese account or phone number.
• Check how your brand ranks on Baidu - brand rank checks for China SEO with positions and snippets per keyword.
• Get Baidu search results in Claude via MCP - let Claude search Baidu live inside the conversation (free trial available).
• Export Baidu Search Results to CSV

中文版 (Chinese)

• 百度搜索 API：无需中国手机号或本地账号
• 百度品牌排名查询API：关键词自然排名位置
• 百度搜索结果 API：通过 MCP 让 Claude 实时查百度
• 百度搜索结果导出CSV接口：标题、链接、摘要与排名

---

📰 Baidu Search API on Medium | Medium 文章

Want a deeper walkthrough? Read Baidu Search API for AI Agents: Search Baidu Without a Chinese Phone Number, a step-by-step guide to pulling structured Baidu results into an AI agent with no Chinese account or phone number.

深入了解：阅读 Medium 文章《Baidu Search API for AI Agents》，了解如何在无需中国手机号或本地账号的情况下将结构化百度搜索结果接入 AI 智能体。

---

Last Updated: 2026.07.13