搜索参数
以 JSON 正文向 POST /v1/search 发送参数。只有 q 是必需的。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
q | string (1–500) | — | 必需。 搜索查询。 |
gl | enum | us | 国家/地区版本（见下文）。 |
hl | string | 国家/地区默认值 | 界面 / 结果语言，BCP-47（例如 en、pt-BR）。 |
tbs | enum | 所有时间 | 时间过滤器：qdr:h（过去一小时）、qdr:d（一天）、qdr:w（一周）。 |
page | integer (1–99) | 1 | 结果页码（从 1 开始；每页约 10 条自然结果）。 |
freshness | enum | default | 缓存控制：default、realtime（强制实时）、cached。参见 缓存。 |
deadline_ms | integer (1000–30000) | 15000 | 每次请求的超时（毫秒）。 |
国家/地区（gl）
Section titled “国家/地区（gl）”br、us、gb、de、fr、es、it、mx、ca、au、jp、nl。
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }时间过滤器（tbs）
Section titled “时间过滤器（tbs）”将结果限制为近期内容 —— 非常适合新闻和热门话题。
{ "q": "nvidia earnings", "tbs": "qdr:d" }分页（page）
Section titled “分页（page）”每页返回大约 10 条自然结果。请求页码 1–99；要收集前 100 条结果，
循环页码 1–10。SDK 暴露了助手方法（searchPages / search_pages）为你迭代页码。