🚀 Apify Baidu Search Scraper | 百度搜索爬虫 (百度)

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

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

---

🌟 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 使用，提供稳定可靠的结果。

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

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

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

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

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

---

🚀 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（开始） - 结果将在数秒内出现在数据集中

---

❓ 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.

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

---

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.

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

Last Updated: 2026.06.03