快速结论
将站点、语言与日期操作符写入 query，再用正文核对事件日期；搜索过滤不能替代来源核验，未知请求字段会被忽略。
- query 支持 1～128 个 Unicode 字符。
- 日期筛选通过 query 中的 after / before 表达。
- 结果 date 为 UTC 的 RFC 3339 格式，未知时可为 null。
本次更新：10 月 20 日核对一手来源后新增；消息日期、发布状态和适用范围在正文标明。
本教程按 10 月 20 日官方 Search 文档整理。下方是请求体示例，没有执行真实检索，也未使用任何密钥。
1. 把筛选条件写进 query
官方支持站点、排除词、精确短语、语言和日期操作符。例子中的时间范围只用于演示搜索 10 月 19–20 日附近的内容，边界与实际正文日期仍需复核。
{
"query": "DeepSeek site:github.com lang:en after:2026-10-18 before:2026-10-21",
"count": 10,
"need_content": true
}
| 语法 | 用途 |
|---|---|
| site:github.com | 限定站点 |
| -site:example.com | 排除站点 |
| "精确短语" | 匹配短语 |
| lang:zh,en | 指定语言 |
| after:2026-10-18 | 筛选指定日期之后发布的网页 |
| before:2026-10-21 | 筛选指定日期之前发布的网页 |
搜索词与操作符共同计入 query 长度。过长时拆成多次有明确目的的搜索，并保存各次条件，避免把时间、站点和所有同义词都塞入一个请求。
2. 不要把任意字段当成有效过滤器
文档说明未知请求字段会被忽略，因此不能自行添加 start_date、end_date 并假设服务一定按它们过滤。localization 的含义是用于优先返回本地化结果的 IP 地址，也不能用它代替语言字段或日期操作符。
3. 核对结果日期和事件日期
响应中的 date 是 UTC 格式，未知时可能为 null。它与网页更新日期、版本标签日期或事件发生日期可能不同。将结果留作候选，再读取发布页或原始公告确认日期；不要因为 date 缺失就补造一个日期。
例如 Nightly 标签使用 20261019，但其 22:04 UTC 的构建时间换算北京时间已是 20 日。新闻标题和正文应说明这一区别。
4. 内容为空时检查下一步
need_content 为 false 时，content 为空字符串；即使请求正文，也可能缺失。需要原文时再按 Fetch 指南读取并核对返回内容。搜索次数、抓取次数和模型用量分别记录，返回 10 条结果不等于发起了 10 次搜索请求。
接口基础接入见Search / Fetch 快速上手。
参考资料
本文依据以下资料整理，版本与接口信息请以来源页面的现行说明为准。