Google SERP（搜索引擎结果页面）是用户在 Google 搜索引擎中输入查询后看到的结果页面。它展示了有机搜索结果、广告、特色摘要、知识图谱以及各种内容（如图片和视频），旨在为用户提供最相关的信息。本文将详细介绍 Google SERP API 的集成方法，该 API 可以返回在 Google 搜索引擎中输入的查询结果，包括特色摘要、知识图谱和图片等多种类型。
申请流程
要使用 Google SERP API，首先需要在 Google SERP API 页面申请相应的服务。进入页面后，点击“获取”按钮，如下图所示：
如果您尚未登录或注册，将自动重定向到登录页面，邀请您注册并登录。登录或注册后，您将自动返回到当前页面。
在首次申请时，将提供一个免费配额，允许您免费使用该 API。
基本用法
了解基本的使用方法，您只需输入搜索资源类型和关键词以获取搜索结果。只需简单地传递 query 字段并指定相应的模型。
例如，要查找“apple inc”的信息，可以在界面上填写相应内容，如下图所示：
在此，我们设置了请求头，包括：
accept: 您想要接收的响应结果格式，填入application/json，即 JSON 格式。authorization: 用于调用 API 的密钥，可以在申请后直接选择。
此外，请求体也进行了设置，包括：
type: 搜索资源的类型，目前默认支持六种类型，默认为search。query: 搜索关键词。country: 搜索结果所在的国家，默认为美国（US）。language: 搜索结果的语言，默认为英语（en）。range: 搜索结果的时间范围，默认为无限制。number: 搜索结果的页面大小，默认为 10。page: 搜索结果的页码，默认为 1。
选择后，可以在右侧找到生成的相应代码，如下图所示：
点击“尝试”按钮进行测试，获取以下结果：
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT5ITHsQzdzkkFWKinRe1Y4FUbC_Vy3R_M&s=0",
"description": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley. It is best known for its consumer electronics, software, and services.",
"description_source": "Wikipedia",
"description_link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"attributes": {
"Customer service": "1 (800) 275-2273",
"Founders": "Steve Jobs, Steve Wozniak, and Ronald Wayne",
"Founded": "April 1, 1976, Los Altos, CA",
"Headquarters": "Cupertino, CA",
"CEO": "Tim Cook (Aug 24, 2011–)"
}
},
"organic": [
{
"title": "Apple",
"link": "https://www.apple.com/",
"snippet": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, ...",
"position": 1
},
...
]
}
返回的结果包含多个字段，具体描述如下：
knowledge_graph: 搜索结果的知识图谱。organic: 搜索结果的详细信息。people_also_ask: 与搜索关键词相关的问题。related_searches: 与搜索关键词相关的搜索。
可以看到，返回结果中的 organic 字段主要包含搜索关键词的结果。
如果您想生成相应的接口代码，可以直接复制生成的代码，例如 CURL 代码如下：
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"query": "apple inc"
}'
Python 接口代码如下：
import requests
url = "https://api.acedata.cloud/serp/google"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"query": "apple inc"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
自定义搜索类型
如果您想自定义搜索资源类型，可以修改参数 type，包括普通资源 search、图片资源 images、新闻资源 news、地图资源 maps、地区资源 places 和视频资源 videos。本节将以视频资源 videos 为例进行演示。
首先，将 type 参数设置为 videos，然后正常传递 query 参数，如下所示：
相应的代码如下：
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"type": "videos",
"query": "apple inc"
}'
您将获得以下响应：
{
"videos": [
{
"title": "Healthcare",
"link": "https://www.apple.com/healthcare/",
"snippet": "More ways to shop: Find an Apple Store or other retailer near you. Or call 1-800-MY-APPLE (1-800-692-7753). United States. Copyright © 2025 Apple Inc. All ...",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRQzUYLXB37srVLPW8JbVzhIlP9-SxMe3A8M98Eb7362as4&s",
"source": "Apple",
"date": "Apr 16, 2025",
"position": 1
},
...
]
}
返回结果中包含 videos 字段，主要包含搜索关键词的结果。
自定义搜索资源的国家
该接口还支持限制搜索结果的国家。我们可以通过添加 country 参数来限制国家，输入参数为国家的缩写，例如 cn（中国）、us（美国）。本节以中国为例，具体信息如下：
输出效果如下：
{
"news": [
{
"title": "Apple announces iOS 26 beta public roll out set for July",
"link": "https://www.tv47.digital/apple-announces-ios-26-beta-public-roll-out-set-for-july-105190/",
"snippet": "Tech giant Apple Inc. has unveiled the latest iterations of its operating systems for iPhone, Mac, and iPad, introducing a significant...",
"date": "2 hours ago",
"source": "TV47 Digital",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBNrktH4AWMt8KS3hErOkI1oAeUvRm4Aaq10qnINCa3TmyabOCwiEMvxVWsA&s",
"position": 1
},
...
]
}
同样，我们可以自定义搜索结果的语言，此外，我们还可以添加 language 字段，其内容为 zh-cn，表示简体中文。其他语言也支持，但语言缩写必须正确输入，例如 en（英语）、fr（法语）、zh-cn（简体中文）等。
自定义搜索结果的时间范围
该 API 还允许自定义搜索结果的时间范围，包括五个选项：qdr:h（过去一小时）、qdr:d（过去一天）、qdr:w（过去一周）、qdr:m（过去一个月），默认值为无限制。我们可以通过 range 参数传递相应的时间范围，例如设置为 qdr:d 表示搜索过去一天的结果。
自定义搜索结果的分页
该 API 还支持自定义搜索结果的分页显示，其中 number 和 page
