API 参数

Google 搜索 API 由以下参数驱动。它们被传递在请求的 input 对象中（请参阅快速入门）。仅 q 为必填项；所有其他参数均为可选，用于细化位置、语言、分页或结果类型。

参数	是否必填	描述
`url`	false	Google 搜索的完整访问链接。与所有其他参数互斥。如果填写了此参数，则无需传递其他请求参数，即使传递也会被自动忽略。
`q`	true	定义您要搜索的查询词。您可以使用常规 Google 搜索中的任何内容，例如 `inurl:`、`site:`、`intitle:`。也支持 `as_dt` 和 `as_eq` 等高级搜索查询参数。
`location`	false	定义搜索的发起位置。如果匹配到多个位置，将使用最热门的一个。`location` 和 `uule` 不能同时使用。建议将 `location` 指定到城市级别，以模拟真实用户的搜索。如果省略，搜索可能会采用代理服务器的位置。
`uule`	false	您希望用于搜索的 Google 编码位置。`uule` 和 `location` 不能同时使用。
`ludocid`	false	定义您要抓取的 Google 我的商家（Google My Business）列表的 ID (CID)。也称为 Google Place ID。
`lsig`	false	您可能需要使用的 ID，用于强制显示知识图谱地图视图。`lsig` ID 可通过 Local Pack API 或 Google Local API 获取，也可通过 Google 我的商家内部使用的重定向获取。
`kgmid`	false	定义您要抓取的 Google 知识图谱（Google Knowledge Graph）列表的 ID (KGMID)。使用 `kgmid` 的搜索将返回原始加密搜索参数的结果。对于某些搜索，`kgmid` 可能会覆盖除 `start` 和 `num` 之外的所有其他参数。
`si`	false	定义您要抓取的 Google 搜索的缓存搜索参数。使用 `si` 的搜索将返回原始加密搜索参数的结果。对于某些搜索，`si` 可能会覆盖除 `start` 和 `num` 之外的所有其他参数。`si` 可用于抓取 Google 知识图谱标签页。
`ibp`	false	负责渲染某些元素的布局和展开内容（例如，`gwp;0,7` 用于展开带有 `ludocid` 的搜索，以显示扩展的知识图谱）。
`uds`	false	启用搜索过滤。它是 Google 提供的过滤字符串。`uds` 值在“filters”部分提供，其中为每个过滤器提供了 `uds`、`q` 和 `serpapi_link` 值。
`google_domain`	false	定义要使用的 Google 域名。默认为 `google.com`。有关支持的域名完整列表，请参阅 Google 域名页面。
`gl`	false	定义用于 Google 搜索的国家/地区。它是一个两位数的国家代码（例如，`us` 代表美国，`uk` 代表英国，`fr` 代表法国）。
`hl`	false	定义用于 Google 搜索的语言。它是一个两位数的语言代码（例如，`en` 代表英语，`es` 代表西班牙语，`fr` 代表法语）。
`cr`	false	定义一个或多个国家/地区以限制搜索范围。使用 `country{两位大写字母国家代码}` 和 `\|` 作为分隔符（例如，`countryFR\|countryDE` 仅搜索法语和德语页面）。
`lr`	false	定义一种或多种语言以限制搜索范围。使用 `lang_{两位字母语言代码}` 和 `\|` 作为分隔符（例如，`lang_fr\|lang_de` 仅搜索法语和德语页面）。
`tbs`	false	(待搜索) 定义常规查询字段中无法实现的高级搜索参数（例如，针对专利、日期、新闻、视频、图片、应用或文本内容的高级搜索）。
`safe`	false	定义成人内容的过滤级别。可设置为 `active` 或 `off`。默认情况下，Google 会模糊处理明确内容。
`nfpr`	false	当原始查询拼写错误时，排除自动更正查询的结果。设置为 `1` 以排除这些结果，或设置为 `0` 以包含它们（默认值）。当没有其他可用结果时，可能无法始终阻止自动更正结果。
`filter`	false	定义“相似结果”和“已省略结果”的过滤器是开启还是关闭。设置为 `1`（默认值）以启用，或设置为 `0` 以禁用。
`tbm`	false	(待匹配) 定义搜索类型。可设置为：（无 `tbm`）常规 Google 搜索，`isch`：Google 图片 API，`lcl`：Google 本地 API，`vid`：Google 视频 API，`nws`：Google 新闻 API，`shop`：Google 购物 API，`pts`：Google 专利 API，或任何其他 Google 服务。
`start`	false	定义分页的结果偏移量（例如，`0`（默认值）为第一页，`10` 为第二页，`20` 为第三页）。Google 本地结果仅接受 `20` 的倍数。
`device`	false	定义用于获取结果的设备。目前仅支持桌面版。

完整参考：Scrapeless API 文档中的 API 参数。

介绍入门