Search API

Search API for real-time SERP results from Google, Bing, DuckDuckGo, Yahoo, and Yahoo Japan, with support for country
and date filtering.

The Search API allows you to perform web searches across multiple providers, returning structured and consistent
results. It supports query customization through parameters like `query`, `countryCode`, and `pagination` via token. The
API is designed to handle common input issues gracefully, returning useful warnings and precise error messages to guide
inte...

原始信息汇总

Search API 数据集概述

基本信息

• API名称: Search API
• 当前版本: v1
• API提供者: Patrick
• 订阅者数量: 68
• 类别: Search
• 服务等级: 100%
• 平均延迟: 1186ms
• 测试通过率: 89%
• 流行度评分: 9.1 (满分10分)

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $20.00 / 月
• MEGA: $40.00 / 月

核心功能概述

该API提供对主流搜索引擎实时搜索结果页面（SERPs）的结构化访问。

支持的搜索引擎

1. Google
2. Bing
3. DuckDuckGo
4. Yahoo
5. Yahoo Japan

主要功能特性

• 国家/地区过滤: 支持为Google、Bing和DuckDuckGo的搜索结果按国家/地区代码过滤。
• 日期过滤: 支持所有搜索引擎按结果发布日期进行筛选。
• 语言过滤: 支持将Yahoo Japan的搜索结果限制为仅日语页面。
• 分页功能: 所有端点均支持通过令牌（token）进行分页。
• 安全搜索: 支持敏感内容过滤（关闭、中等、严格三级）。
• 统一输出格式: 所有搜索结果均以统一的JSON格式返回。

目标用户群体

• SEO专业人员：用于跨地区和搜索引擎跟踪关键词表现。
• 市场研究人员：用于分析全球竞争对手的存在和趋势。
• 开发人员：用于将搜索功能集成到应用程序中，无需处理网页抓取和验证码。
• 学术研究人员：用于研究搜索引擎行为或新闻随时间的传播。

端点详情

1. Search Bing

• 端点URL: /v1/search/bing
• 必需参数: query（查询关键词）、countryCode（国家代码，格式：^[A-Za-z]{2}$）
• 可选参数: datePosted（发布日期限制）、safeSearch（安全搜索级别）、token（分页令牌）

2. Search DuckDuckGo

• 端点URL: /v1/search/duckduckgo
• 必需参数: query（查询关键词）、countryCode（国家代码，格式：^[A-Za-z]{2}$）
• 可选参数: datePosted（发布日期限制）、safeSearch（安全搜索级别）、token（分页令牌）

3. Search Google

• 端点URL: /v1/search/google
• 必需参数: query（查询关键词）、countryCode（国家代码，格式：^[A-Za-z]{2}$）
• 可选参数: datePosted（发布日期限制）、safeSearch（安全搜索级别）、token（分页令牌）

4. Search Yahoo

• 端点URL: /v1/search/yahoo
• 必需参数: query（查询关键词）
• 可选参数: datePosted（发布日期限制）、token（分页令牌）

5. Search Yahoo Japan

• 端点URL: /v1/search/yahoo-japan
• 必需参数: query（查询关键词）
• 可选参数: datePosted（发布日期限制）、japaneseOnly（仅日语结果，布尔值）、token（分页令牌）

响应格式

所有端点的响应均遵循统一的JSON结构： json { "data": [ { "description": "结果描述", "title": "结果标题", "url": "结果URL" } ], "meta": { "position": 0, "count": 10, "nextToken": "分页令牌" }, "_links": { "self": "当前请求链接", "next": "下一页链接" }, "errors": [], "warnings": [], "hasError": false, "hasWarning": false }

分页机制

• 使用响应中meta.nextToken的值作为token参数请求下一批结果。
• 设置token参数时，通常可以省略其他URL参数。

错误与警告处理

错误类型

响应中包含hasError和hasWarning字段指示是否存在问题。

常见错误代码

代码	错误类型	消息	描述
400	MISSING_PARAMETER	400: Required parameter ... is missing.	缺少必需的URL参数
400	MISSING_OR_PARAMETER	400: Either parameter ... or parameter ... must to be set.	缺少两个必需参数之一
400	INVALID_PARAMETER	400: Parameter ... contains an invalid value, valid values are ...	URL参数值无效
400	INVALID_PARAMETER_FORMAT	400: The value of parameter ... does not match the expected format: ...	URL参数格式无效
504	PROXY_TIMEOUT	504: Proxy timed out, please try again.	代理服务超时
500	UNEXPECTED_EXCEPTION	500: An unexpected error occurred.	发生意外错误

警告类型

常见警告代码

代码	错误类型	消息	描述
200	UNKNOWN_PARAMETER	200: Parameter ... is unknown and was ignored.	设置了未知URL参数，已被忽略
200	NOT_RECOMMENDED_PARAMETER	200: Parameter ... is not recommended.	设置了不推荐的URL参数

技术优势

• 提供一致的结构化输出
• 支持灵活的过滤选项
• 优雅处理常见输入问题
• 返回有用的警告和精确的错误消息
• 节省处理网页抓取和验证码的时间与精力
• 提供可靠、本地化的搜索数据，适用于分析和自动化任务

搜集汇总

背景与挑战

背景概述

该数据集提供多搜索引擎（Google/Bing等）的实时搜索结果API，支持按国家/日期筛选和查询参数定制，具备结构化的结果返回和友好的错误处理机制。