DuckDuckGo 搜索
DuckDuckGo 通用搜索 SERP，支持关键词检索、地区参数和安全过滤。
本页给出 DuckDuckGo 搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | DuckDuckGo 搜索 |
| 原始名称 | Duckduckgo Search |
| 内部标识（scraper） | duckduckgo_search |
| 接口标识（engine） | duckduckgo_search |
| 网站 | DuckDuckGo |
| 网站地址 | Duckduckgo.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 5 |
| 参数分组 | 搜索词 (1), 高级筛选 (2), 地区与语言 (1), 请求控制 (1) |
必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
q | string | 搜索词 | 你想让搜索引擎检索的关键词或短语。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。
搜索词
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 你想让搜索引擎检索的关键词或短语。 |
高级筛选
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
df | string | 否 | 日期筛选参数，可用于只保留最近结果或自定义时间范围。 |
safe | number | 否 | 用于控制成人内容过滤级别的安全搜索参数。 |
附加约束
safe：默认值：1；可选值：3 个可选值，例如：1、-1、-2
地区与语言
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
kl | string | 否 | DuckDuckGo 的地区代码。 |
附加约束
kl：默认值：us-en；可选值：64 个可选值，例如：ar-es、au-en、at-de、be-fr、be-nl
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
no_cache：默认值：false