Google SERP API 对接说明
Google SERP(Search Engine Results Page)是用户在Google搜索引擎中输入查询后看到的结果页面。它显示自然搜索结果、广告、特色摘要、知识图谱以及图片、视频等多种内容,旨在为用户提供最相关的信息。
本文将详细介绍 Google SERP API,它可以提供在Google搜索引擎中输入查询获取结果,结果的内容也是包含了许多类型,比如特色摘要、知识图谱以及图片等多种结果。
本文档会介绍下 Google SERP API 的对接说明。
申请流程
要使用 Google SERP API,需要先到 Google SERP API 对应页面申请对应的服务,进入页面之后,点击「Acquire」按钮,如图所示:
如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送,可以免费使用该 API。
基本使用
首先先了解下基本的使用方式,就是输入搜索关键词,就能获得搜索结果,只需要简单地传递一个 query
字段,并指定相应模型即可。
比如说询问:“apple inc”,我们接下来就可以在界面上填写对应的内容,如图所示:
可以看到这里我们设置了 Request Headers,包括:
accept
:想要接收怎样格式的响应结果,这里填写为application/json
,即 JSON 格式。authorization
:调用 API 的密钥,申请之后可以直接下拉选择。
另外设置了 Request Body,包括:
action
:搜索资源的类型,目前只支持六种类型,默认是search
。query
:搜索的关键词。country
:自定义搜索结果的所在国家,默认是美国(US)。language
:自定义搜索结果的语言,默认是英语(en)。range
:自定义搜索结果的时间范围,默认是没有限制的。number
:自定义搜索结果的分页页面大小,默认是10。page
:自定义搜索结果的分页页数,默认是1。
选择之后,可以发现右侧也生成了对应代码,如图所示:
点击「Try」按钮即可进行测试,如上图所示,这里我们就得到了如下结果:
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwGQRv5TjjkycpctY66mOg_e2-npacrmjAb6_jAWhzlzkFE3OTjxyzbA&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",
"Headquarters": "Cupertino, CA",
"COO": "Jeff Williams",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, CA"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
},
],
"position": 1
},
{
"title": "Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"snippet": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley.",
"sitelinks": [
{
"title": "History",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
},
],
"position": 2
},
{
"title": "Apple Inc. (AAPL) Company Profile & Facts - Yahoo Finance",
"link": "https://finance.yahoo.com/quote/AAPL/profile/",
"snippet": "See the company profile for Apple Inc. (AAPL) including business summary, industry/sector information, number of employees, business summary, ...",
"position": 3
},
],
"people_also_ask": [
{
"question": "What is Apple Inc stand for?",
"snippet": "It was incorporated as Apple Computer, Inc. in January 1977, and sales of its computers, including the Apple II , saw significant momentum and revenue growth for the company. \"Inc.\" is the abbreviation for incorporated. A corporation is a separate legal entity from the person or people forming it.",
"title": "What does the 'Inc.' in Apple Inc. mean? - Quora",
"link": "https://www.quora.com/What-does-the-Inc-in-Apple-Inc-mean"
},
],
"related_searches": [
{
"query": "Macintosh"
},
{
"query": "Apple Inc full form"
},
],
"credits": 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)
自定义搜索类型
如果您自定义搜索资源的类型,我们可以修改参数 action
,它分别包含了普通资源 search
、图片资源 images
、新闻资源 news
、地图资源 maps
、地区资源 places
、视频资源 videos
,本文将以视频资源 videos
做一个示范。
下面我们来演示下具体的操作。
首先,将 action
参数设置为 videos
,并正常传递 query
参数,如图所示:
对应代码如下:
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer 018e9d5864524c0fb3ef725c676a0daa' \
-H 'content-type: application/json' \
-d '{
"action": "videos",
"query": "apple inc"
}'
可以得到如下回答:
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwGQRv5TjjkycpctY66mOg_e2-npacrmjAb6_jAWhzlzkFE3OTjxyzbA&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",
"Headquarters": "Cupertino, CA",
"COO": "Jeff Williams",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, CA"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
}
],
"position": 1
}
],
"places": [
{
"title": "Apple Inc.",
"address": "Austin, TX",
"cid": "6364221923344007436"
}
],
"people_also_ask": [
{
"question": "What is Apple Inc stand for?",
"snippet": "It was incorporated as Apple Computer, Inc. in January 1977, and sales of its computers, including the Apple II , saw significant momentum and revenue growth for the company. \"Inc.\" is the abbreviation for incorporated. A corporation is a separate legal entity from the person or people forming it.",
"title": "What does the 'Inc.' in Apple Inc. mean? - Quora",
"link": "https://www.quora.com/What-does-the-Inc-in-Apple-Inc-mean"
}
],
"related_searches": [
{
"query": "Macintosh"
}
],
"credits": 1
}
可以看到,得到的结果与上文类似。
自定义搜索资源所在国家
该接口也支持限定搜索结果的所在国家,我们可以添加 country
参数来限定国家,输入的参数为国家的简写,比如cn(China)、us(United States),本文将以China做如下示例,下面为具体的信息:
输出效果如下:
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwGQRv5TjjkycpctY66mOg_e2-npacrmjAb6_jAWhzlzkFE3OTjxyzbA&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": "400 666 8800",
"Founders": "Steve Jobs, Steve Wozniak, and Ronald Wayne",
"Headquarters": "Cupertino, California, United States",
"COO": "Jeff Williams",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, California, United States"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
}
],
"position": 1
},
{
"title": "Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"snippet": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley.",
"sitelinks": [
{
"title": "History",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
}
],
"position": 2
},
{
"title": "Apple Inc. (AAPL) Company Profile & Facts - Yahoo Finance",
"link": "https://finance.yahoo.com/quote/AAPL/profile/",
"snippet": "See the company profile for Apple Inc. (AAPL) including business summary, industry/sector information, number of employees, business summary, ...",
"position": 3
}
],
"people_also_ask": [
{
"question": "What is the Apple Inc?",
"snippet": "Apple Inc., originally Apple Computer, Inc., is a multinational corporation that creates and markets consumer electronics and attendant computer software, and is a digital distributor of media content. Apple's core product lines are the iPhone smartphone, iPad tablet computer, and the Macintosh personal computer.",
"title": "History of Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
}
],
"related_searches": [
{
"query": "Apple Inc full form"
}
],
"credits": 1
}
可以看到,结果中是在China国家的搜索结果,具体的内容与上文是类似的。
自定义搜索结果语言
我们还可以自定义搜索结果的语言,这里我们额外添加 language
字段,内容为 zh-cn
,其中它指的是简体中文的语言,同时还支持其他语言,但必须输入的语言的简写,比如en(English)、fr(French)、zh-cn(Chinese(Simplified))等语言,如图所示:
对应代码如下:
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",
"language": "zh-cn"
}'
运行结果如下:
{
"knowledge_graph": {
"title": "苹果",
"type": "公司",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRgbY1KzXEpuPeTpcw0GwN6BpQTcg1m06TDUsfdG6P-zW3eWrmu78AXyg&s=0",
"attributes": {
"创始人": "史蒂夫·乔布斯、史蒂夫·沃兹尼亚克和罗纳德·韦恩",
"创立于": "1976 年 4 月 1 日,加利福尼亚洛思阿图斯",
"总部": "加利福尼亚库比蒂诺"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
}
],
"position": 1
},
{
"title": "Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"snippet": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley.",
"sitelinks": [
{
"title": "History",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
}
],
"position": 2
},
{
"title": "Apple Inc. | History, Products, Headquarters, & Facts - Britannica",
"link": "https://www.britannica.com/money/Apple-Inc",
"snippet": "Apple Inc. is an American multinational technology company that revolutionized the technology sector through its innovation of computer software, ...",
"position": 3
}
],
"people_also_ask": [
{
"question": "What is Apple Inc stand for?",
"snippet": "It was incorporated as Apple Computer, Inc. in January 1977, and sales of its computers, including the Apple II , saw significant momentum and revenue growth for the company. \"Inc.\" is the abbreviation for incorporated. A corporation is a separate legal entity from the person or people forming it.",
"title": "What does the 'Inc.' in Apple Inc. mean? - Quora",
"link": "https://www.quora.com/What-does-the-Inc-in-Apple-Inc-mean"
}
],
"related_searches": [
{
"query": "apple inc是什么"
}
],
"credits": 1
}
可以看到这里显示的结果都是简体中文的语言,结果的内容与上文类似。
自定义搜索结果时间范围
本文还可以自定义搜索结果的时间范围,包括了五种,分别是 qdr:h
(过去一个小时)、qdr:d
(过去一天)、qdr:w
(过去一周)、qdr:m
(过去一个月)、默认无限制,我们可以通过 range
传递对应的时间范围即可,比如这里设置为 qdr:d
,这样表示搜索过去一天的结果,所以输入如下:
对应的代码如下:
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"range": "qdr:d",
"query": "apple inc"
}'
运行结果如下:
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwGQRv5TjjkycpctY66mOg_e2-npacrmjAb6_jAWhzlzkFE3OTjxyzbA&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",
"Headquarters": "Cupertino, CA",
"COO": "Jeff Williams",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, CA"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
}
],
"position": 1
},
{
"title": "Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"snippet": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley.",
"sitelinks": [
{
"title": "History",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
}
],
"position": 2
},
{
"title": "Apple Inc. (AAPL) Company Profile & Facts - Yahoo Finance",
"link": "https://finance.yahoo.com/quote/AAPL/profile/",
"snippet": "See the company profile for Apple Inc. (AAPL) including business summary, industry/sector information, number of employees, business summary, ...",
"position": 3
}
],
"places": [
{
"title": "Apple Inc.",
"address": "Austin, TX",
"cid": "6364221923344007436"
},
{
"title": "Apple Lonestar Design Center",
"address": "West Lake Hills, TX",
"cid": "96664910012456098"
},
{
"title": "Apple The Summit",
"address": "Birmingham, AL",
"cid": "15135424056620472574"
}
],
"people_also_ask": [
{
"question": "What is Apple Inc stand for?",
"snippet": "It was incorporated as Apple Computer, Inc. in January 1977, and sales of its computers, including the Apple II , saw significant momentum and revenue growth for the company. \"Inc.\" is the abbreviation for incorporated. A corporation is a separate legal entity from the person or people forming it.",
"title": "What does the 'Inc.' in Apple Inc. mean? - Quora",
"link": "https://www.quora.com/What-does-the-Inc-in-Apple-Inc-mean"
}
],
"related_searches": [
{
"query": "Macintosh"
}
],
"credits": 1
}
可以看到,我们就成功得到了过去一天的搜索结果,结果内容与上文类似。
自定义搜索结果分页
本API还支持自定义搜索结果的分页展示,number
和 page
表示分页的页面大小和页数,本文将设置一页里面有20个搜索结果的形式来进行分页展示,具体的信息如图所示:
代码如下:
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer 018e9d5864524c0fb3ef725c676a0daa' \
-H 'content-type: application/json' \
-d '{
"query": "apple inc",
"number": 20,
"page": 1
}'
运行结果如下:
{
"knowledge_graph": {
"title": "Apple",
"type": "Technology company",
"website": "http://www.apple.com/",
"image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwGQRv5TjjkycpctY66mOg_e2-npacrmjAb6_jAWhzlzkFE3OTjxyzbA&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",
"Headquarters": "Cupertino, CA",
"COO": "Jeff Williams",
"CEO": "Tim Cook (Aug 24, 2011–)",
"Founded": "April 1, 1976, Los Altos, CA"
}
},
"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, ...",
"sitelinks": [
{
"title": "Support",
"link": "https://support.apple.com/"
}
],
"position": 1
},
{
"title": "Apple Inc. - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"snippet": "Apple Inc. is an American multinational corporation and technology company headquartered in Cupertino, California, in Silicon Valley.",
"sitelinks": [
{
"title": "History",
"link": "https://en.wikipedia.org/wiki/History_of_Apple_Inc."
}
],
"position": 2
}
],
"people_also_ask": [
{
"question": "What is Apple Inc stand for?",
"snippet": "It was incorporated as Apple Computer, Inc. in January 1977, and sales of its computers, including the Apple II , saw significant momentum and revenue growth for the company. \"Inc.\" is the abbreviation for incorporated. A corporation is a separate legal entity from the person or people forming it.",
"title": "What does the 'Inc.' in Apple Inc. mean? - Quora",
"link": "https://www.quora.com/What-does-the-Inc-in-Apple-Inc-mean"
}
],
"related_searches": [
{
"query": "Macintosh"
}
],
"credits": 2
}
可以看到,这里它对搜索结果进行了分页展示,一页里面展示了20条结果,结果的内容与上文类似。