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」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：
1 |
{ |
返回结果一共有多个字段，介绍如下：
knowledge_graph，搜索结果的知识图谱。organic，搜索结果的详细信息。people_also_ask，跟搜索关键词相关的问题。related_searches，对于搜素关键词的相关搜索。
可以看到，这里返回的结果中有一个 organic 字段，它主要包含了搜索关键词的结果。
另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：
1 |
curl -X POST 'https://api.acedata.cloud/serp/google' \ |
Python 的对接代码如下：
1 |
import requests |
自定义搜索类型
如果您自定义搜索资源的类型，我们可以修改参数 type，它分别包含了普通资源 search、图片资源 images、新闻资源 news、地图资源 maps、地区资源 places、视频资源 videos，本文将以视频资源 videos 做一个示范。
下面我们来演示下具体的操作。
首先，将 type 参数设置为 videos，并正常传递 query 参数，如图所示：
对应代码如下：
1 |
curl -X POST 'https://api.acedata.cloud/serp/google' \ |
可以得到如下回答：
1 |
{ |
返回结果一共有多个字段，介绍如下：
news，搜索结果中视频信息列表。
可以看到，这里返回的结果中有一个 videos 字段，它主要包含了搜索关键词的结果。
自定义搜索资源所在国家
该接口也支持限定搜索结果的所在国家，我们可以添加 country 参数来限定国家，输入的参数为国家的简写，比如 cn（China）、us（United States），本文将以 China 做如下示例，下面为具体的信息：
输出效果如下：
1 |
{ |
可以看到，结果中是在 China 国家的搜索结果，具体的内容与上文是类似的。
自定义搜索结果语言
我们还可以自定义搜索结果的语言，这里我们额外添加 language 字段，内容为 zh-cn，其中它指的是简体中文的语言，同时还支持其他语言，但必须输入的语言的简写，比如 en（English）、fr（French）、zh-cn（Chinese（Simplified））等语言，如图所示：
对应代码如下：
1 |
curl -X POST 'https://api.acedata.cloud/serp/google' \ |
运行结果如下：
1 |
{ |
可以看到这里显示的结果都是简体中文的语言，结果的内容与上文类似。
自定义搜索结果时间范围
本文还可以自定义搜索结果的时间范围，包括了五种，分别是 qdr:h（过去一个小时）、qdr:d（过去一天）、qdr:w（过去一周）、qdr:m（过去一个月）、默认无限制，我们可以通过 range 传递对应的时间范围即可，比如这里设置为 qdr:d，这样表示搜索过去一天的结果，所以输入如下：
对应的代码如下：
1 |
curl -X POST 'https://api.acedata.cloud/serp/google' \ |
运行结果如下：
1 |
{ |
可以看到，我们就成功得到了过去一天的搜索结果，结果内容与上文类似。
自定义搜索结果分页
本 API 还支持自定义搜索结果的分页展示，number 和 page 表示分页的页面大小和页数，本文将设置一页里面有 20 个搜索结果的形式来进行分页展示，具体的信息如图所示：
注意：当每页结果超过 10 个时，扣除的积分会翻倍。
代码如下：
1 |
curl -X POST 'https://api.acedata.cloud/serp/google' \ |
运行结果如下：
1 |
{ |
可以看到，这里它对搜索结果进行了分页展示，一页里面展示了 20 条结果，结果的内容与上文类似。
