🔍 搜索引擎 API
统一搜索引擎接口，支持 Google、Bing、Baidu 三大搜索引擎。选择参数，生成 API 请求，直接执行查看结果。
BASE https://api.deepshields.com/v1
引擎 Google · Bing · Baidu
认证 api_key (query 参数)
格式 JSON
📖 参数说明
所有参数均通过 URL Query String 传递。GET /v1/search?q=xxx&engine=google&api_key=YOUR_KEY
| 参数 | 必填 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
q | 是 | string | — | 搜索关键词，支持中英文。例如 cybersecurity、人工智能安全 |
api_key | 是 | string | — | API 密钥，登录后在个人中心获取。格式：sk-user-xxxx |
engine | 否 | string | google | 搜索引擎。可选值：google、bing、baidu |
num | 否 | int | 10 | 返回搜索结果条数。范围 1~50。Google/Baidu 通常最多 10 条/页 |
start | 否 | int | 0 | 结果偏移量，用于翻页。第 2 页填 10，第 3 页填 20。Bing 暂不支持翻页 |
hl | 否 | string | en | 界面语言 (Host Language)。影响搜索结果的语言偏好。常用：en 英文、zh-CN 简体中文、ja 日文、ko 韩文 |
gl | 否 | string | us | 地区 (GeoLocation)。影响搜索结果的地域偏好，使用 ISO 3166 两字母国家码。常用：us 美国、cn 中国、jp 日本 |
no_cache | 否 | bool | false | 是否跳过缓存。设为 true 时每次都会实时查询搜索引擎，不使用缓存结果 |
safe | 否 | string | off | 安全搜索。active 开启安全过滤，off 关闭 |
tbs | 否 | string | — | 时间范围过滤 (Google 专用)。例如 qdr:d 最近一天、qdr:w 最近一周、qdr:m 最近一月、qdr:y 最近一年 |
📦 响应结构
成功响应 HTTP 200，返回 JSON 对象，核心字段如下：
| 字段 | 类型 | 说明 |
|---|---|---|
search_metadata | object | 请求元信息：请求 ID、引擎、后端、耗时等 |
search_parameters | object | 实际使用的搜索参数（包括默认值） |
organic_results | array | 自然搜索结果列表。每条包含 position（排名）、title（标题）、link（链接）、snippet（摘要） |
knowledge_graph | object | 知识图谱卡片（如果有）。包含标题、描述、图片等 |
related_searches | array | 相关搜索建议 |
people_also_ask | array | 其他人还在搜（Google 专用） |
answer_box | object | 精选摘要 / 即时回答（如果有） |
inline_videos | array | 内嵌视频结果（如果有） |
🚀 API 测试台
⚠ 当前使用体验 Key，请登录或替换为您自己的 API Key
⚠️ 错误码
| HTTP 状态码 | 说明 | 常见原因 |
|---|---|---|
| 200 | 成功 | — |
| 401 | 未认证 | 未提供 api_key 参数 |
| 403 | 认证失败 | api_key 无效 |
| 422 | 参数错误 | num 超出范围、类型错误等 |
| 429 | 限流 | 超过速率限制 |
| 501 | 未实现 | 请求了 🔜 计划中的引擎 |