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)

请求示例

下面的请求体是本次文档更新时实际用于验证 duckduckgo_search 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"duckduckgo_search","q":"openai"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "created_at": "2026-03-26 08:34:18 UTC",
    "id": "01KMMMF2PD9PM1NS46M5X4D29W",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMF2PD9PM1NS46M5X4D29W.json",
    "processed_at": "2026-03-26 08:34:18 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMF2PD9PM1NS46M5X4D29W.html",
    "status": "completed",
    "total_time_taken": 10
  },
  "search_parameters": {
    "engine": "duckduckgo_search",
    "q": "openai"
  },
  "total_credits_used": 1,
  "ads": [
    {
      "link": "https://duckduckgo.com/y.js?ad_domain=chatbotai.co&ad_provider=bingv7aa&ad_type=txad&click_metadata=TQO3jy32lZ2TpUwc2x7Rpn9JKGj9hq2%2DV022rtHAFWbXZZbigj3mpHRl42PJbava3zPp5SnHcYcOVaSa2rXh48uhH%2DPh%2DMOeK1wr5oVcD%2DBMbIwB... [truncated, 2241 chars]",
      "position": 1,
      "sitelinks": [
        {
          "href": "https://duckduckgo.com/y.js?ad_domain=chatbotai.co&ad_provider=bingv7aa&ad_type=txad&click_metadata=krpK_IxthBJa_MHK4U4MZHg5R98xhtK5Bx4nTzp8Ly6enB3BlMY6LMkQtt6_mADe6UodOrcwBo2Uhs2gMx9RA7f9hWI1Tp78jMS5TybfVcUWZ3tKFWU09eYy... [truncated, 2615 chars]",
          "title": "Sign In"
        },
        {
          "_note": "3 more items omitted"
        }
      ],
      "snippet": "Write essays, emails, or papers easily with the AI chatbot developed on GPT 5.2. Compare top LLMs and pick the right one for your task. All models in one workspace.",
      "source": "https://chatbotai.co › ai › chatbot",
      "title": "Unlock All AI Models - AI Chat Developed on GPT-5.2"
    }
  ],
  "organic_results": [
    {
      "favicon": "https://external-content.duckduckgo.com/ip3/openai.com.ico",
      "link": "https://openai.com/",
      "position": 1,
      "snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems. Building safe and beneficial AGI is our mission.",
      "title": "OpenAI"
    },
    {
      "_note": "9 more items omitted"
    }
  ],
  "related_searches": [
    {
      "link": "http://duckduckgo.com?q=openai.com&kl=us-en",
      "query": "openai. com "
    },
    {
      "_note": "7 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 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

引擎列表

DuckDuckGo 搜索