DuckDuckGo 新闻搜索

DuckDuckGo 新闻 SERP，支持新闻检索、地区参数和安全过滤。

本页给出 DuckDuckGo 新闻搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	DuckDuckGo 新闻搜索
原始名称	Duckduckgo News Search
内部标识（scraper）	`duckduckgo_news`
接口标识（engine）	`duckduckgo_search_news`
网站	DuckDuckGo
网站地址	duckduckgosearchnews.com
输出格式	`json`
版本	`1.0.0`
参数数量	`4`
参数分组	搜索词 (1), 地区与语言 (1), 高级筛选 (2)

请求示例

下面的请求体是本次文档更新时实际用于验证 duckduckgo_news 的请求。对于 /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_news","q":"OpenAI"}'

响应示例

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

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:18:21 UTC",
    "id": "01KMMKHX94BAT0B2G9PM1HGANH",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKHX94BAT0B2G9PM1HGANH.json",
    "processed_at": "2026-03-26 08:18:21 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKHX94BAT0B2G9PM1HGANH.html",
    "status": "completed",
    "total_time_taken": 10
  },
  "search_parameters": {
    "engine": "duckduckgo_news",
    "q": "OpenAI"
  },
  "total_credits_used": 1,
  "news_results": [
    {
      "link": "https://mashable.com/article/openai-sora-pivot-sam-altman",
      "position": 1,
      "source": "Mashable",
      "thumbnail": "https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fhelios-i.mashable.com%2Fimagery%2Farticles%2F05eb1DrztyJQykXTdYrHmcf%2Fhero-image.fill.size_1200x675.v1774492922.jpg&f=1&ipt=66a7d874513ceac4cb5aa705e02446dde2e... [truncated, 249 chars]",
      "title": "Why is OpenAI like this?"
    },
    {
      "_note": "29 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

搜索词

参数	类型	必填	说明
`q`	`string`	是	你想让搜索引擎检索的关键词或短语。

地区与语言

参数	类型	必填	说明
`kl`	`string`	否	DuckDuckGo 的地区代码。

附加约束

kl：可选值：64 个可选值，例如：ar-es、au-en、at-de、be-fr、be-nl

高级筛选

参数	类型	必填	说明
`ndf`	`string`	否	Filter By Date 参数。
`safe`	`number`	否	用于控制成人内容过滤级别的安全搜索参数。

附加约束

safe：默认值：1；可选值：3 个可选值，例如：1、-1、-2

引擎列表

DuckDuckGo 新闻搜索