跳转到主要内容
Google SERP（Search Engine Results Page）是用户在 Google 搜索引擎中输入查询后看到的结果页面。它显示自然搜索结果、广告、特色摘要、知识图谱以及图片、视频等多种内容，旨在为用户提供最相关的信息。 本文将详细介绍 Google SERP API，它可以提供在 Google 搜索引擎中输入查询获取结果，结果的内容也是包含了许多类型，比如特色摘要、知识图谱以及图片等多种结果。 本文档会介绍下 Google SERP API 的对接说明。

​
申请流程

要使用 Google SERP API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。 如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：Google SERP API →

​
基本使用

首先先了解下基本的使用方式，就是输入搜索资源类型和关键词，就能获得搜索结果，只需要简单地传递 query 字段，并指定相应模型即可。 比如说查找：关于“apple inc”的信息，我们接下来就可以在界面上填写对应的内容，如图所示：

可以看到这里我们设置了 Request Headers，包括：
  • accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
另外设置了 Request Body，包括：
  • type：搜索资源的类型，目前只支持六种类型，默认是 search。
  • query：搜索的关键词。
  • country：自定义搜索结果的所在国家，默认是美国（US）。
  • language：自定义搜索结果的语言，默认是英语（en）。
  • range：自定义搜索结果的时间范围，默认是没有限制的。
  • number：自定义搜索结果的分页页面大小，默认是 10。
  • page：自定义搜索结果的分页页数，默认是 1。
选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：
返回结果一共有多个字段，介绍如下：
  • knowledge_graph，搜索结果的知识图谱。
  • organic，搜索结果的详细信息。
  • people_also_ask，跟搜索关键词相关的问题。
  • related_searches，对于搜素关键词的相关搜索。
可以看到，这里返回的结果中有一个 organic 字段，它主要包含了搜索关键词的结果。 另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：
Python 的对接代码如下：

​
自定义搜索类型

如果您自定义搜索资源的类型，我们可以修改参数 type，它分别包含了普通资源 search、图片资源 images、新闻资源 news、地图资源 maps、地区资源 places、视频资源 videos，本文将以视频资源 videos 做一个示范。 下面我们来演示下具体的操作。 首先，将 type 参数设置为 videos，并正常传递 query 参数，如图所示：

对应代码如下：
可以得到如下回答：
返回结果一共有多个字段，介绍如下：
  • news，搜索结果中视频信息列表。
可以看到，这里返回的结果中有一个 videos 字段，它主要包含了搜索关键词的结果。

​
自定义搜索资源所在国家

该接口也支持限定搜索结果的所在国家，我们可以添加 country 参数来限定国家，输入的参数为国家的简写，比如 cn（China）、us（United States），本文将以 China 做如下示例，下面为具体的信息：

输出效果如下：
可以看到，结果中是在 China 国家的搜索结果，具体的内容与上文是类似的。

​
自定义搜索结果语言

我们还可以自定义搜索结果的语言，这里我们额外添加 language 字段，内容为 zh-cn，其中它指的是简体中文的语言，同时还支持其他语言，但必须输入的语言的简写，比如 en（English）、fr（French）、zh-cn（Chinese（Simplified））等语言，如图所示：

对应代码如下：
运行结果如下：
可以看到这里显示的结果都是简体中文的语言，结果的内容与上文类似。

​
自定义搜索结果时间范围

本文还可以自定义搜索结果的时间范围，包括了五种，分别是 qdr:h（过去一个小时）、qdr:d（过去一天）、qdr:w（过去一周）、qdr:m（过去一个月）、默认无限制，我们可以通过 range 传递对应的时间范围即可，比如这里设置为 qdr:d，这样表示搜索过去一天的结果，所以输入如下：

对应的代码如下：
运行结果如下：
可以看到，我们就成功得到了过去一天的搜索结果，结果内容与上文类似。

​
自定义搜索结果分页

本 API 还支持自定义搜索结果的分页展示，number 和 page 表示分页的页面大小和页数，本文将设置一页里面有 20 个搜索结果的形式来进行分页展示，具体的信息如图所示：

注意：当每页结果超过 10 个时，扣除的积分会翻倍。
代码如下：
运行结果如下：
可以看到，这里它对搜索结果进行了分页展示，一页里面展示了 20 条结果，结果的内容与上文类似。