Documentation has been updated: see help center and changelog in one place.

网页搜索

全面的 Google 搜索抓取器,提供有机结果、广告、摘要、知识面板等的解析数据。

google_search 该 source 旨在检索 Google 搜索 (SERP) 和 Google AI Overviews 结果。本子页面专门展示与 Google 网络搜索 相关的信息。要探索其他结果类型,请阅读 图片搜索 新闻搜索.

请求示例

在下面的示例中,我们发出请求以获取 2 结果页,从第 11 页到第 12 ,针对搜索词 adidasgoogle.nl 域。SERP 将被过滤为仅包含法语结果。API 将返回解析后的结果。

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "domain": "nl",
        "query": "adidas",
        "start_page": 11,
        "pages": 2,
        "parse": true,
        "context": [
            {
                "key": "results_language",
                "value": "fr"
            }
        ]
    }'

在我们的示例中,我们使用同步的 Realtime 集成方法。如果您想使用 Proxy Endpoint 或异步的 Push-Pull 集成,请参阅 集成方法 部分。

请求参数值

通用

用于抓取 Google 网络搜索结果的基本设置和自定义选项。

参数
说明
默认值

source

设置抓取器。

google_search

query

要搜索的关键字或短语。

-

render

启用 JavaScript 渲染,当设置为 html. 更多信息.

-

parse

当设置为以下值时返回解析后的数据 true。 查看输出 数据字典.

false

callback_url

回调端点的 URL。 更多信息.

-

user_agent_type

设备类型和浏览器。完整列表可在 此处.

desktop

- 必填参数

Google 高级搜索运算符

在抓取时,将 Google 高级搜索运算符与查询结合使用可能很有用。它使您能够自定义搜索范围,确保结果更相关、更聚焦。探索这些特殊命令 此处此处。参见下面示例。

{
    "source": "google_search",
    "query": "iphone 15 launch inurl:apple",
}

本地化

将搜索结果适配到特定的地理位置、域和语言。

参数
说明
默认值

geo_location

应为其适配结果的地理位置。正确使用此参数对于获取正确数据非常重要。有关更多信息,请阅读我们建议的 geo_location 参数结构 此处.

-

domain

Google 的域本地化。可用域的完整列表可在此处找到 此处.

com

locale

Accept-Language 更改您 Google 搜索页面 Web 界面语言的请求头值。 更多信息.

-

context: results_language

结果语言。支持的 Google 语言列表可在此处找到 此处。 了解如何使用上下文参数 此处.

-

分页

用于管理分页和检索搜索结果的控制项。

参数
说明
默认值

start_page

起始页码。

1

pages

要检索的页数。

1

limit

每页要检索的结果数量。

10

context:limit_per_page

使用相同的 IP 地址和会话(cookie 集)抓取多页。通过在 JSON 数组中使用 page 键指定页码,并使用 limit 键指明每页的自然结果数量,您可以将跨页出现重叠自然结果的概率降到最低(例如,第一页的最后一个自然结果与第二页的第一个自然结果相同)。 参见示例.

-

支持连续滚动

网页爬虫 API 完全支持 Google 搜索的连续滚动。它会自动检测连续滚动布局,有效加载请求的自然结果,而无需任何额外参数。

每页限制

要使用此功能,请在 JSON 数组中包含包含以下数据的 JSON 对象:

参数
说明
示例

page

您想要抓取的页码。任何大于 0 的整数值均可

1

limit

该页上的结果数量。任何介于 1100 (含)之间的整数值均可。

90

请求示例

{
    "source": "google_search",
    "query": "adidas",
    "parse": true,
    "context": [
        {
            "key": "limit_per_page",
            "value": [
                {"page": 1, "limit": 10},
                {"page": 2, "limit": 90}
                    ]
        }]
}

过滤

用于基于各种条件过滤和优化搜索结果的选项。了解如何使用上下文参数 此处.

参数
说明
默认值

context: filter

将此参数的值设置为 0 可让您看到因与其他结果相似而本应被排除的结果。

1

context: safe_search

安全搜索。设置为 true 以启用它。

false

context: udm

udm 参数允许在不同的搜索选项卡之间切换,例如图片、地点或视频,以自定义显示的结果类型。查找可接受的值 此处.

-

context: tbm

要匹配或 tbm 参数。接受的值包括: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

-

context: tbs

该参数类似于容纳更晦涩 Google 参数的容器,例如按日期限制/排序结果以及其他某些依赖于 tbm 参数(例如 tbs=app_os:1 仅在与 tbm value app一起使用时可用)。更多信息 此处.

-

其他

用于专门需求的附加高级设置和控制。

参数
说明
默认值

context: fpstate

fpstate 的值设置为 aig 将使 Google 加载更多应用。仅在与 render 参数一起使用时该参数才有用。

-

context: nfpr

true 将关闭拼写自动更正

false

上下文参数

所有上下文参数应作为对象添加到 context 数组中,包含 keyvalue 键值对,例如:

...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...

结构化数据

网页爬虫 API 能够提取包含 Google 搜索结果的 HTML 或 JSON 对象,提供有关结果页各个元素的结构化数据。

google_search 结构化输出
{
    "results": [
        {
            "content": {
                "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
                "page": 1,
                "results": {
                    "pla": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/nmd_r1-primeblue-shoes/GZ9257.html?dfw_tracker=24819-GZ9257-0010",
                                "price": "$150.00",
                                "title": "NMD_R1 Primeblue Shoes Black M 8.5 / W 9.5 - Mens Originals Shoes",
                                "seller": "adidas",
                                "url_image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSZALnENHKXERktsOCnUSscRd4v0cSUw9E0XPaZwgyruM0Wuw-MhWcchAVzZRBdS-OP3_167R3jCg&usqp=CAc",
                                "image_data": "iVBORw0KGgoAAAANSUhEU...JRU5ErkJggg=="
                            },
                            {
                                "pos": 22,
                                "url": "https://www.adidas.com/us/ultraboost-5.0-dna-shoes/GY6452.html?dfw_tracker=24819-GY6452-0006",
                                "price": "$90.00",
                                "title": "Ultraboost 5.0 DNA Shoes Magic Grey 13K - Kids Originals Shoes",
                                "seller": "adidas",
                                "url_image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSTCgTZ1im_6ZX9YSCrjQfjVEnTmpmiqqYAHAhXzA9VhJdrokOeOnWsbEOxqA8zPkaos192xPF5ogA&usqp=CAc",
                                "image_data": "iVBORw0KGgoAAAANSUhEU...kJggg=="
                            }
                        ],
                        "pos_overall": 1
                    },
                    "paid": [],
                    "images": {
                        "items": [
                            {
                                "alt": "Image result for adidas",
                                "pos": 1,
                                "url": "/search?q=adidas&gl=us&h...E#imgrc=Dw-CBW17i8BqsM",
                                "source": "https://www.britannica.com/topic/Adidas-AG"
                            },
                            {
                                "alt": "Image result for adidas",
                                "pos": 10,
                                "url": "/search?q=adidas&gl=us&hl=en&tbm=isch&sourXRM%252Cvz-MIh...QF6BAhLEAE#imgrc=_oOH_rR4W_-X-M",
                                "source": "https://www.shutterstock.com/search/adidas"
                            }
                        ],
                        "pos_overall": 11
                    },
                    "organic": [
                        {
                            "pos": 1,
                            "url": "https://www.adidas.com/us",
                            "desc": "adidas 不仅关乎运动服和锻炼服。我们与业内最佳合作共同创造。通过这种方式,我们为粉丝提供运动用品,...",
                            "title": "adidas 官方网站 | adidas US",
                            "sitelinks": {
                                "expanded": [
                                    {
                                        "url": "https://www.adidas.com/us/women",
                                        "title": "Women"
                                    },
                                    {
                                        "url": "https://www.adidas.com/us/sale",
                                        "title": "Sale"
                                    }
                                ]
                            },
                            "url_shown": "https://www.adidas.com› ...",
                            "pos_overall": 2
                        },
                        {
                            "pos": 5,
                            "url": "https://play.google.com/store/apps/details?id=com.adidas.app&hl=en_US&gl=US",
                            "desc": "YOUR ADIDAS - MORE THAN A SHOPPING APP The home of sport and sneakers, the adidas app puts you closer to the action with access to sneaker drops, ...Size: 115MUpdated: May 3, 2022 Rating: 4.8 · ‎322,391 votes · ‎Free · ‎Android · ‎Sports",
                            "title": "adidas - Apps on Google Play",
                            "url_shown": "https://play.google.com› store › apps › details › id=com....",
                            "pos_overall": 12
                        }
                    ],
                    "twitter": {
                        "pos": 1,
                        "url": "https://twitter.com/adidas",
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://twitter.com/adidas/status/1521901157064531968?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "What do you like to listen to most during workouts?",
                                "timeframe": "5 days ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "How would you describe your favorite sport to an alien?",
                                "timeframe": "Apr 27, 2022"
                            }
                        ],
                        "title": "",
                        "pos_overall": 7
                    },
                    "knowledge": {
                        "title": "Adidas",
                        "factoids": [
                            {
                                "title": "Customer service chat",
                                "content": "Online Chat"
                            },
                            {
                                "title": "Website",
                                "content": "http://www.adidas-group.com/"
                            }
                        ],
                        "profiles": [
                            {
                                "url": "https://www.instagram.com/adidas",
                                "title": "Instagram"
                            },
                            {
                                "url": "https://www.youtube.com/user/adidas",
                                "title": "YouTube"
                            }
                        ],
                        "subtitle": "Design company",
                        "description": "Adidas AG 是一家德国跨国公司,总部位于巴伐利亚 Herzogenaurach,设计和制造鞋类、服装和配件。它是欧洲最大的运动服制造商,世界第二,仅次于耐克。",
                        "related_searches": [
                            {
                                "url": "/search?gl=us&hl=en&q=Nike&si=AC1wQDCwN61-ebmuwbQCO5QCrgOvEq5bkWeIzJ5JczItzAKNdbIxoHfFJ8UFY3e1CorwNJXI6gTWniM6aVu3nEoseblyAI-5N39_1F3DTWWABELjIdJa9ZgI_g5n-c9ZUZdzEZeV2VGOkDNPl5DwiBeyifKPveoCnBsiT3wVpKdr52FPqK5rzQSzspA-sjztjVcZy2WfOwFITo5EfSXyZ5AsknO1X-dzXUCOlIIGCvFWqi9OKgK5PaWp7EcXls7n8Ag_L7HC3Pgg2k5FWR631X7Hvi1268shAg%3D%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAU",
                                "title": "Nike"
                            },
                            {
                                "url": "/search?gl=us&hl=en&q=Asics&si=AC1wQDDagiMg03ncxeOQZbwVe-CJxRCchC-jr2hCPTxjc9wbgNZ1pCnWqLo_0N5RPhArBCY1qCgzESLe6Y9hB2HKnzquQNjJW9iLV6gQvDXzTwkl6LZHjq2aOuZII0W5uCWjpc0oOVU5JzyOjRUNEYoe_N_KsbL4xn4A0Fl2S4JMYAeaBZmu8jPX8EFVl_C3gerS4CRTyrfcL2bL-VhUNLEXVUlkFxrLlAyeZfUMVYSDo4WqV1c8-Bgp-rBwBzqW73Q7s1kOZHBtCQ8aBNfbfulPCljSG9vXBrcj9RqQRA8pD8TlH1rz8qE%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAs",
                                "title": "Asics"
                            }
                        ]
                    },
                    "top_stories": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/adilette-comfort-slides/GZ5898.html",
                                "title": "adidas Adilette Comfort Slides - Beige | women swim | adidas US",
                                "source": "",
                                "timeframe": "8 hours ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "Women's Clothing Sale Up to 50% Off | adidas US",
                                "source": "",
                                "timeframe": "Sep 30, 2021"
                            }
                        ],
                        "pos_overall": 3
                    },
                    "instant_answers": [
                        {
                            "type": "unknown",
                            "_parsed": false,
                            "pos_overall": 5
                        }
                    ],
                    "popular_products": {
                        "items": [
                            {
                                "pos": 1,
                                "title": "Adidas Yeezy Kids Foam Runner",
                                "image_data": "UklGRhwJAABXRUJQVlA...rAZNVIAAA"
                            },
                            {
                                "pos": 10,
                                "title": "Adidas Men's Kaptir 2.0",
                                "image_data": "UklGRhQNAAB...+wTh1cLB/uQAAAAAAAAA="
                            }
                        ],
                        "pos_overall": 4
                    },
                    "related_searches": {
                        "pos_overall": 14,
                        "related_searches": [
                            "adidas shoes",
                            "adidas yeezy",
                            "adidas outlet",
                            "adidas pants",
                            "adidas sneakers",
                            "adidas superstar",
                            "adidas wikipedia"
                        ]
                    },
                    "search_information": {
                        "query": "adidas",
                        "showing_results_for": "adidas",
                        "total_results_count": 1440000000
                    },
                    "total_results_count": 1440000000,
                    "related_searches_categorized": [
                        {
                            "category": {
                                "name": "Adidas logo",
                                "type": "collapsed"
                            },
                            "pos_overall": 13
                        }
                    ]
                },
                "last_visible_page": 10,
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 07:24:16",
            "updated_at": "2022-05-09 07:24:20",
            "page": 1,
            "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "6929330182268395521",
            "status_code": 200,
            "parser_type": "v2"
        }
    ]
}

元素的组成可能会根据其是否为 desktop移动 搜索而有所不同。

为帮助您识别某些元素,请参阅针对桌面或移动搜索获得的每种 Google 搜索结果类型的数据字典。

输出数据字典

使用右侧导航或向下滚动页面浏览详细信息。

HTML 示例

JSON 结构

Google 网络搜索的结构化输出包含诸如 URL, page, results等字段。下表列出我们解析的每个 SERP 功能的详细清单、其描述和数据类型。表中还包含一些元数据。

特定结果类型的项数和字段可能会根据搜索查询而有所不同。

键名称
说明
类型

url

Google 搜索页面的 URL。

字符串

page

相对于 Google SERP 分页的页码。

整数

results

包含搜索结果的字典。

对象

results.pla

包含各自详细信息的商品列表广告清单。

对象

results.paid

包含各自详细信息的赞助结果清单。

数组

results.images

包含各自详细信息的图片结果清单。

对象

results.flights

包含各自详细信息的航班清单。

对象

results.organic

包含各自详细信息的非付费列表清单。

数组

results.organic_videos

包含各自详细信息的自然视频清单。

数组

results.top_sights

包含各自详细信息的知名地标或景点清单。

数组

results.jobs

包含各自详细信息的职位列表。

对象

results.local_service_ads

包含赞助本地服务提供商的清单。

对象

results.video_box

单个视频项及其相应详细信息。

对象

results.recipes

包含各自详细信息的食谱清单。

对象

results.twitter

包含各自详细信息的 Twitter (X) 结果清单。

数组

results.knowledge

从知识面板检索到的相关信息清单。

对象

results.local_pack

包含与搜索相关的本地商家列表。

对象

results.item_carousel

用于信息性查询的示例性商品清单及其相应详细信息。

对象

results.videos

包含各自详细信息的视频清单。

对象

results.related_searches_categorized

其他人执行的相关搜索清单。

数组

results.hotels

与搜索查询中使用的位置相关的酒店清单。

对象

results.apps

包含各自详细信息的应用清单。

数组

results.finance

公司财务数据摘要,包括股票价格、市值和其他关键指标。

对象

results.sports_games

有关近期体育比赛的信息,详细说明比分、队伍、比赛类型和亮点。

对象

results.discussions_and_forums

包含带有 URL、标题、来源和评论数的讨论线程和论坛帖子的清单。

对象

results.featured_snippet

从 SERP 自然部分检索到的特定结果清单。

数组

results.top_stories

当搜索查询被识别为新闻导向时,包含各自详细信息的文章清单。

对象

results.popular_products

包含 Google 购物产品列表的非付费自然展示及其相应详细信息的清单。

对象

results.related_searches

在搜索页不同位置展示的一个或多个相关搜索块的清单。

数组

results.related_questions

包含各自详细信息的相关疑问搜索查询清单。

对象

results.what_people_are_saying

包含带有 URL、标题、来源、热门评论、参与度和时间范围的讨论线程和论坛帖子的清单。

数组

results.search_information

提交的搜索查询的详细信息清单。

对象

total_results_count

针对搜索查询找到的结果总数。

字符串

last_visible_page

标识搜索查询结果页中可见的最大页码的值。(当通过滚动触发加载更多结果时为 -1)。

整数

parse_status_code

解析任务的状态代码。您可以在此处查看解析器状态代码说明 此处.

整数

created_at

抓取任务创建的时间戳。

时间戳

updated_at

抓取任务完成的时间戳。

时间戳

job_id

与抓取任务关联的作业 ID。

字符串

status_code

抓取任务的状态代码。您可以在此处查看爬虫状态代码说明 此处.

整数

parser_type

用于解析 HTML 内容的解析器类型。

字符串

在下列部分,当某个结果类型有多于一项时,解析后的 JSON 代码片段将被简短化。

商品列表广告 (PLA)

pla 此搜索结果部分指商品列表广告,也称为 Google 购物广告,通常以轮播格式在搜索页顶部突出展示。

...
"pla": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.amazon.com/Switch-Controllers-Wildcat-Touchscreen-Bluetooth/dp/B09N4S9TWV?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A1GYW88KAZG2FO",
            "price": "$675.49",
            "title": "Switch PURTCH Newest w/Yellow & Blue controllers Wildcat Bundle(2000 V-Bucks and Code for Wildcat Bundle Included), 6.2\" Touchscreen LCD Display, 802.11",
            "seller": "Amazon.com",
            "url_image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSdvbTlG8SxMmPAm6cjeiFXvrNCIF0ZIBUUqz4B4Uww2fY7sHhaEQxbDv_JP78tu-YO3kWFbTESJPcAx5h2zezUK3bpZJnVriMGOi7Tx7nJNA8&usqp=CAc",
            "image_data": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        },
        ...
    ],
    "pos_overall": 1
},
...
键 (results.pla)
说明
类型
布局

items

页面内所有可用的 PLA。

数组

桌面和移动端

items.pos

指示给定项目在 PLA 结果中的位置。

整数

桌面和移动端

items.url

商品的 URL。

字符串

桌面和移动端

items.price

列表广告中商品的价格。

字符串

桌面和移动端

items.title

列表广告中商品的标题。

字符串

桌面和移动端

items.seller

列表广告中商品的卖家。

字符串

桌面和移动端

items.url_image

商品图片的 URL。

字符串

桌面

items.image_data

商品缩略图的 base64 编码图像。

字符串

桌面和移动端

pos_overall

PLA SERP 功能在搜索结果页面(SERP)中的位置指示。

整数

桌面和移动端

付费

paid 该部分指由 Google Ads 提供的广告,通常出现在自然(非付费)结果之上。

... 
"paid": [
    {
        "pos": 1,
        "url": "https://www.adidas.com/us/cyber_monday",
        "desc": "最后的网络特卖机会。使用代码 CYBERSALE 额外 45% 折扣,适用于促销和正价商品。今天就在 adidas® 官方网站购物。加入我们的 adiClub 忠诚计划。会员专属奖励。adiClub 独家优惠.",
        "title": "adidas 官方网站 | 额外 45% 折扣 | 代码 CYBERSALE",
        "data_rw": "https://www.google.com/aclk?...",
        "sitelinks": {
            "expanded": [
                {
                    "url": "https://www.adidas.com/us/shop",
                    "desc": "最后的网络特卖机会。使用代码 CYBERSALE 额外 45% 折扣.",
                    "title": "网络星期一促销"
                },
                {
                    "url": "https://www.adidas.com/us/shoes",
                    "desc": "今天就找到合适的鞋子。线上提供运动与生活方式鞋款.",
                    "title": "adidas® 鞋款"
                },
                {
                    "url": "https://www.adidas.com/us/ultraboost",
                    "desc": "惊人的能量回馈,今日选购全新 Ultraboost™ Light.",
                    "title": "adidas® Ultraboost™ Light"
                },
                {
                    "url": "https://www.adidas.com/us/nmd",
                    "desc": "线上选购 adidas Originals 最新 NMD 鞋款发布.",
                    "title": "adidas® NMD"
                }
            ]
        },
        "url_shown": "https://www.adidas.com \u203a official \u203a site",
        "pos_overall": 1
    }
],
... 
键 (results.paid)
说明
类型
布局

pos

表示某项在付费结果中位置的指示器。

整数

桌面和移动端

url

付费结果的 URL。

字符串

桌面和移动端

desc

付费结果的简短描述。

字符串

桌面和移动端

title

付费结果的标题。

字符串

桌面和移动端

data_rw

付费结果的重定向 URL。

字符串

桌面和移动端

sitelinks

包含关于网站内部链接的信息,这些内部链接显示在 Google 首个搜索结果下方。

对象

桌面和移动端

sitelinks.inline/expanded

包含 URL 及其各自详情的列表。键名(`inline`/`expanded`)指定 sitelinks 元素的类型。

数组

桌面和移动端

sitelinks.inline.url

链接网站的 URL。

字符串

桌面和移动端

sitelinks.inline.title

链接网站的标题。

字符串

桌面和移动端

sitelinks.inline.description

链接网站的简短描述。

字符串

桌面

url_shown

显示在描述下方的简短可见 URL。

字符串

桌面和移动端

pos_overall

付费结果在搜索结果页面中位置的指示。

整数

桌面和移动端

图片

images 该部分指在搜索结果页面不同位置显示的图片结果,可能作为专用板块或置顶显示。请注意,从 Google 搜索结果抓取的数据结构可能与从 Google 图片搜索抓取的数据结构不同。

...
"images": {
    "items": [
        {
            "alt": "Adidas | History, Products, & Facts | Britannica",
            "pos": 1,
            "url": "https://www.britannica.com/topic/Adidas-AG"
        },
        {
            "alt": "Superstar x Indigo Herz Shoes",
            "pos": 2,
            "url": "https://www.adidas.com/us/superstar-x-indigo-herz-shoes/IE1842.html"
        },
        {
            "alt": "adidas (@adidas) / X",
            "pos": 3,
            "url": "https://twitter.com/adidas"
        }
    ],
    "pos_overall": 4
},
...
键 (results.images)
说明
类型
布局

items

带有各自详情的图片列表。

数组

桌面和移动端

items.alt

图片的 alt 文本。

字符串

桌面和移动端

items.pos

表示图像在列表中位置的唯一指示符。

整数

桌面和移动端

items.url

包含图像的网页的 URL。

字符串

桌面和移动端

pos_overall

Images SERP 功能在搜索结果页面中位置的指示。

整数

桌面和移动端

自然

organic 该部分指 Google 自然搜索结果中的非付费列表,由 Google 的算法根据相关性决定。这些列表出现在搜索页面的付费广告下方。

示例 1

...
"organic": [
    {
        "pos": 1,
        "url": "https://www.loveandlemons.com/brownies-recipe/",
        "desc": "最好的布朗尼食谱!使用可可粉和巧克力碎片制作,这些自制布朗尼口感 fudgy、gooey、超级巧克力味且易于制作!",
        "title": "最佳自制布朗尼食谱",
        "images": [
            "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        ],
        "sitelinks": {
            "inline": [
                {
                    "url": "https://www.loveandlemons.com/recipes/vegetarian-recipes/",
                    "title": "素食食谱"
                },
                {
                    "url": "https://www.loveandlemons.com/baking-recipes/",
                    "title": "25 个超有趣的烘焙食谱"
                },
                {
                    "url": "https://www.loveandlemons.com/oatmeal-cookies/",
                    "title": "完美燕麦饼干"
                }
            ]
        },
        "url_shown": "https://www.loveandlemons.com\u203a Recipes",
        "pos_overall": 2
    },
...

示例 2

...
"organic": [
    {
        "pos": 9,
        "pos_overall": 13,
        "title": "Classics Winter Track Jacket - Army Green",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "一件源自户外冬季运动的柔软羊羔绒运动夹克 · 宽松版型休闲且不受束缚 · 面料:70% 聚酯纤维 / 30% 再生...",
        "favicon_text": "Reebok",
        "images": [
            "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS7NvhUuvYcmAxmRNswAEkR6HZo-KYMwmNcynhHjwa2UE1l8cjy4isr&s"
        ],
        "rating": 3.9,
        "review_count": 7,
        "additional_info": [
            "$23.99$80",
            "In stock",
            "3.9(7)",
            "Free delivery over $75",
            "Free 30-day returns"
        ]
    },
...
键 (results.organic)
说明
类型
布局

pos

表示某项在自然结果中位置的指示器。

整数

桌面和移动端

url

自然结果的 URL。

字符串

桌面和移动端

desc

自然结果的简短描述。

字符串

桌面和移动端

title

自然结果的标题。

字符串

桌面和移动端

images

自然结果的 base64 编码缩略图图片。

字符串

桌面和移动端

sitelinks

对象包含 `expanded` 或 `inline` 元素,提供关于 sitelinks 的更多详情。

对象

桌面和移动端

sitelinks.expanded/inline

自然结果的 sitelinks 列表。键名(inline/expanded)指定 sitelinks 元素的类型。

数组

桌面和移动端

sitelinks.expanded.url

链接网站的 URL。

字符串

桌面和移动端

sitelinks.expanded.title

链接网站的标题。

字符串

桌面和移动端

url_shown

显示在描述下方的简短可见 URL。

字符串

桌面和移动端

pos_overall

Organic 结果在搜索结果页面中位置的指示。

整数

桌面和移动端

favicon_text

与网站图标(favicon)相关的文本或名称。

字符串

桌面

rating

产品或内容的平均评分。

float

桌面

review_count

与产品或内容相关的评论数量。

整数

桌面

additional_info

包含有关价格、可用性、产品评分、配送选项、退货政策的详细信息。

字符串列表

桌面

自然视频

results.organic_videos 包含以自然方式显示在搜索结果中的视频列表,即它们不是付费广告。每个视频条目包括视频标题、URL、描述等相关详情。

...
 "organic_videos": [
    {
        "pos": 1,
        "url": "https://www.youtube.com/watch?v=XHTrLYShBRQ",
        "desc": "您的浏览器无法播放此视频。了解详情.",
        "title": "介绍 iPhone 15 | WOW | Apple - YouTube",
        "pos_overall": 6
    },
...
键 (results.organic_videos)
说明
类型
布局

pos

表示某项在自然视频结果中位置的指示器。

整数

桌面

url

视频的 URL。

字符串

桌面

desc

视频的简短描述。

字符串

桌面

title

视频的标题。

字符串

桌面

pos_overall

Organic Video 结果在搜索结果页面中位置的指示。

整数

桌面

热门景点

results.top_sights 包含与搜索位置或主题通常相关的重要地标或景点列表。每个条目包括在列表中的位置和标题等详情。

...
"top_sights": {
    "items": [
        {
            "pos": 1,
            "title": "维尔纽斯大教堂"
        },
        {
            "pos": 2,
            "title": "Gediminas 城堡塔"
        },
        {
            "pos": 3,
            "title": "晨曦之门"
        }
    ],
    "pos_overall": 1
},
...
键 (results.top_sights)
说明
类型
布局

items

包含顶级景点及其各自详情的列表。

数组

桌面

items.pos

Top Sights 结果在 Top Sights SERP 功能中的位置。

整数

桌面

items.title

旅游景点名称的标题。

字符串

桌面

pos_overall

Top Sights 结果在搜索结果页面中位置的指示。

整数

桌面

职位

results.jobs 包含从搜索结果中提取的职位列表。每个职位条目包括指向招聘信息的 URL、职位标题、来源、雇主和地点等详情。列表来自 Google 索引的各种招聘板块、职业网站和其他平台。

...
"jobs": {
    "listings": [
        {
            "url": "https://www.google.com/search?q=divorce+lawyer+jobs&filter=1&safe=off&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&ibp=htl;jobs&sa=X&ved=2ahUKEwjI1ZPX2sGEAxVrcGwGHcEpAjAQkd0GegQIIRAB#fpstate=tldetail&htivrt=jobs&htiq=divorce+lawyer+jobs&htidocid=PezDD3LkXHvbWvM-AAAAAA%3D%3D",
            "title": "律师",
            "source": "via LinkedIn",
            "employer": "Men's & Fathers' Rights Divorce Lawyers, Schultz & Associates, LLC",
            "location": "United States"
        },
                            ...
    ],
    "pos_overall": 1
},
...
键 (results.jobs)
说明
类型
布局

listings

页面中可用的所有职位列表的数组。

数组

桌面

listings.url

完整职位列表的 URL。

字符串

桌面

listings.title

职位的标题。

字符串

桌面

listings.source

包含原始职位发布的来源。

字符串

桌面

listings.employer

发布该职位的组织。

字符串

桌面

listings.location

职位的工作地点。

字符串

桌面

pos_overall

Jobs SERP 功能在搜索结果页面中位置的指示。

整数

桌面

Twitter (X)

twitter 该功能常为品牌、电影、音乐人和其他名人展示,通常位于品牌官网搜索结果下方。该功能提供指向品牌 Twitter 订阅页的直接链接,展示其最新推文的轮播。

...
"twitter": {
    "pos": 1,
    "url": "https://twitter.com/NintendoAmerica",
    "items": [
        {
            "pos": 1,
            "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
            "content": "您现在可以兑换 #MyNintendo 铂金点数以收集节日主题自定义图标,活动至 12/25 美西时间 17:00 截止。#NintendoSwitchOnline #MissionsAndRewards\n\n了解更多:ninten.do/6017iHF1b",
            "timeframe": "12 hours ago"
        },
        ...
    ],
    "title": "Nintendo of America (@NintendoAmerica) \u00b7 X",
    "pos_overall": 4
},
...
键 (results.twitter)
说明
类型
布局

pos

表示某项在自然结果中位置的指示器。

整数

桌面

url

包含 Twitter (X) 帖子的个人资料的 URL。

字符串

桌面

items

带有各自详情的 Twitter (X) 帖子列表。

数组

桌面

items.pos

表示某条推文在 Twitter (X) SERP 功能中位置的指示器。

字符串

桌面

items.url

Twitter (X) 帖子的 URL。

字符串

桌面

items.content

该 Twitter (X) 帖子的全部文本的简短描述。

字符串

桌面

items.timeframe

描述该推文创建于多久以前。

字符串

桌面

title

Twitter (X) 个人资料的标题。

字符串

桌面

pos_overall

Twitter 结果在搜索结果页面中位置的指示。

整数

桌面

知识

knowledge 搜索结果中的该部分在搜索人物、地点、组织或已整合进知识图谱的实体时,会在右侧显示 Google 知识面板数据。

...
"knowledge": {
    "title": "Adidas",
    "images": [
        "iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..."
    ],
    "factoids": [
        {
            "links": [
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "创始人"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "阿道夫·达斯勒"
                }
            ],
            "title": "创始人",
            "content": "阿道夫·达斯勒"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "服装公司",
    "description": "描述:Adidas AG 是一家总部位于德国巴伐利亚 Herzogenaurach 的德国家用运动服饰和鞋类公司。它是欧洲最大的运动服制造商,全球仅次于耐克。维基百科",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "人们也在搜索"
        },
        ...
    ]
},
...
键 (results.knowledge)
说明
类型
布局

title

知识面板的标题。

字符串

桌面和移动端

images

紧挨标题的用于展示的一组图片列表。

数组

桌面

factoids

知识面板中使用的所有事实项的列表。

数组

桌面和移动端

factoids.links

与给定 factoid 项相关的所有链接的列表。

数组

桌面和移动端

factoids.links.href

指向该 factoid 的 Google 搜索结果页面的超链接。

字符串

桌面和移动端

factoids.links.title

与该 factoid 相关的任何链接页面的描述。

字符串

桌面和移动端

factoids.title

factoid 区块的名称。

字符串

桌面和移动端

factoids.content

factoid 的描述。

字符串

桌面和移动端

profiles

知识面板中列出的社交媒体资料列表。

字符串

桌面

profiles.url

指向社交媒体资料的链接。

字符串

桌面

profiles.title

社交媒体资料的标题。

字符串

桌面

subtitle

关于标题中所描述实体的简短说明。

字符串

桌面和移动端

description

描述知识面板中关于该实体的主要信息。

字符串

桌面和移动端

related_searches

具有各自详情的相关搜索列表。

数组

桌面

related_searches.url

相关搜索页面的 URL。

字符串

桌面

related_searches.title

相关搜索页面的标题。

字符串

桌面

related_searches.section_title

相关搜索板块的名称。

字符串

桌面

本地包

local_pack 显示基于用户位置或指定搜索位置的前三个本地搜索结果,包括地图和附加信息。

...
"local_pack": {
                        "items": [
                            {
                                "cid": "1100080596967423812",
                                "pos": 1,	
                                "title": "必胜客",
                                "rating": 3.8,
                                "address": "Independence, KS",
                                "subtitle": "披萨",
                                "rating_count": 435
                            },
                            ...
                        ],
                        "pos_overall": 1
                    },
...
键 (results.local_pack)
说明
类型
布局

items

包含位置及其各自详情的列表。

数组

桌面和移动端

items.cid

分配给特定商家列表的唯一识别号码。

字符串

桌面和移动端

items.pos

本地结果在本地包中的位置。

整数

桌面和移动端

items.title

本地实体的标题。

字符串

桌面和移动端

items.rating

本地实体的评分。

整数

桌面和移动端

items.address

本地实体的地址。

字符串

桌面和移动端

items.rating_count

本地实体的评分数量。

整数

桌面和移动端

pos_overall

Local Pack 结果在搜索结果页面中位置的指示。

整数

桌面和移动端

头条新闻

top_stories 是一个专门在 Google 搜索中为新闻相关查询显示的板块。

...
"top_stories": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.independent.co.uk/arts-entertainment/films/news/elon-musk-leave-the-world-behind-b2462401.html",
            "title": "Netflix 用户嘲讽对《Leave the World Behind》感到“触发”的埃隆·马斯克 \n抱怨 11 小时前",
            "source": "The Independent",
            "timeframe": "11 hours ago"
        },
        ...
    ],
    "pos_overall": 3
},
...
键 (results.top_stories)
说明
类型
布局

items

所选新闻文章及其各自详情的列表。

数组

桌面和移动端

items.pos

文章在 Top Stories SERP 功能中的位置。

整数

桌面和移动端

items.url

完整文章的 URL。

字符串

桌面和移动端

items.title

文章的标题。

字符串

桌面和移动端

items.section

Top Stories 板块的名称。

字符串

移动端

items.source

文章发布网站的名称。

字符串

桌面和移动端

items.timeframe

描述文章发布的时间距离现在的时长。

字符串

桌面

pos_overall

表示 Top Stories SERP 功能在搜索结果页面中的整体位置。

整数

桌面和移动端

热门商品

popular_products 该 SERP 功能展示按受欢迎程度和与用户查询相关性排列的商品轮播。这与受广告商影响的商品列表广告(PLA)不同。值得注意的是,单个搜索结果页面上可能出现多个 popular_products 轮播可能会出现在单个搜索结果页面上。\

...
"popular_products":[
   {
      "items":[
         {
            "pos":1,
            "price":"$109.99",
            "title":"adidas Gazelle Herren",
            "seller":"Footlocker.de",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         {
            "pos":2,
            "price":"$120.00",
            "title":"Herren adidas Gazelle Schuh",
            "rating":"4.9",
            "seller":"JD Sports Deutschland",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         ...
      ],
      "pos_overall":4
   },
   ...
]
...
键 (results.popular_products)
说明
类型
布局

items

带有各自详情的热门商品列表。

数组

桌面和移动端

items.pos

表示某个热门商品在 Popular Products SERP 功能中位置的唯一指示符。

整数

桌面和移动端

items.price

某个热门商品的价格。

字符串

桌面和移动端

items.title

某个热门商品的标题。

字符串

桌面和移动端

items.rating

某个热门商品的评分。

字符串

桌面

items.seller

某个热门商品的卖家。

字符串

桌面

items.image_data

商品缩略图的 base64 编码图像。

字符串

桌面

pos_overall

Popular Products SERP 功能在搜索结果页面中的整体位置。

整数

桌面和移动端

相关搜索

related_searches 该 SERP 功能展示与初始搜索关键词相关的替代搜索查询,通常位于搜索结果页面底部。

"related_searches": [
   {
       "pos_overall": 12,
       "related_searches": [
           "tesla model 3",
           "tesla car price", 
           "tesla model y",
           "tesla owner",
           "tesla - wikipedia", 
           "tesla cybertruck",
           "tesla 2023",
           "tesla logo"
       ]
   }
],
键 (results.related_searches)
说明
类型
布局

pos_overall

指示该相关搜索块在搜索页面中的整体位置。

整数

桌面和移动端

related_searches

该块中包含的相关搜索字符串列表。

数组

桌面和移动端

相关问题

related_questions 该功能位于主要搜索结果下方,展示与用户原始查询直接相关的问题列表。通过提供精选的相关问题,用户可以探索主题的不同方面,从而提升整体搜索体验。

...
"related_questions": {
    "items": [
        {
            "pos": 1,
            "answer": "根据 1995 年的吉尼斯世界纪录,截至当时,《圣经》是史上最畅销的书籍,估计销量和发行量达 50 亿册.",
            "source": {
                "url": "https://en.wikipedia.org/wiki/List_of_best-selling_books#:~:text=According%20to%20Guinness%20World%20Records,billion%20copies%20sold%20and%20distributed.",
                "title": "最畅销书籍列表 - 维基百科",
                "url_shown": "Wikipediahttps://en.wikipedia.org \u203a wiki \u203a List_of_best-selling_..."
            },
            "question": "世界上排名第 1 的书是哪本?"
        },
        ...
    ],
    "pos_overall": 2
},
...
键 (results.related_questions)
说明
类型
布局

items

包含所有相关问题的列表。

数组

桌面和移动端

items.pos

表示任一相关问题在 Related Questions SERP 功能中位置的唯一指示符。

整数

桌面和移动端

items.answer

相关问题的答案。

字符串

桌面和移动端

items.source

包含描述用于获取问题答案来源的值。

对象

桌面和移动端

items.source.url

用于获取答案的网站的 URL。

字符串

桌面

items.source.title

包含答案的网站的标题。

字符串

桌面

items.source.url_shown

显示在答案下方的简短可见 URL。

字符串

桌面和移动端

items.question

相关问题部分中的问题。

字符串

桌面和移动端

pos_overall

Related Questions SERP 功能在搜索结果页面中的整体位置指示。

整数

桌面和移动端

人们在说什么

what_people_are_saying 当论坛、社交媒体或社区平台上存在与查询相关的帖子时,该部分会出现在 Google 搜索结果中。此部分通常显示来自 Reddit、TikTok 及其他讨论论坛的内容。

...
"what_people_are_saying": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.reddit.com/r/travel/comments/1kxf875/san_francisco_hotels/",
                                "title": "旧金山酒店",
                                "top_comments": "欢迎来到旧金山!几点说明。\n* 十月通常是一年中我们天气最好的时候。很棒的计划!(提醒其他读者:旧金山的“夏天”通常非常多雾且很冷.)\n* (这可能很显而易见,提前道歉。也许对其他读者有帮助。) 49 人队实际上并不在旧金山附近比赛。若无交通,市中心到 Levi's 的车程约一小时。乘公共交通(或配合 Uber/Lyft)大约需 90-120 分钟。\n* 我建议住在旧金山市区内。如果不想住在旧金山,靠近 BART 的地方可以让你在不花太多钱的情况下观光。\n* 在旧金山市区内,要注意 Tenderloin 区是相对粗糙的社区。那是你在福克斯新闻上常看到的“失控的旧金山”报道中的地方。城市的其他部分安全且相对干净。\n* 旧金山西侧,尤其是 Sunset 区,与公共交通的连接较少。完全可以不用车出行,但到市中心或火车站会花更长时间。\n恭喜你退休!听起来像是很不错的奖励.",
                                "source": "Reddit",
                                "engagement_timeframe": "10+ comments, 1 week ago"
                            },
                            {
                                "pos": 2,
                                "url": "https://www.tiktok.com/@kaorihatsusee/video/7501124173717065006",
                                "title": "真的很喜欢我们在这里的住宿 🫶🏼 @maya hangai 📍Kasa La Monarca, San Francisco #affordable #affordablehotel #hotel #sanfrancisco"
                                "source": "TikTok",
                                "engagement_timeframe": "45.3K+views, 3 weeks ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco",
                                "title": "旧金山 23 家最佳酒店,从使命湾到卡斯特罗区"
                                "source": "Condé Nast Traveller",
                                "engagement_timeframe": "1 month ago"
                            }
                        ]
                    }
...
键 (results.what_people_are_saying)
说明
类型
布局

items

包含所有讨论论坛或社交媒体内容条目的列表。

数组

桌面和移动端

items.url

讨论帖或社交媒体内容页面的 URL。

整数

桌面和移动端

items.title

讨论帖或内容条目的标题。

字符串

桌面和移动端

items.top_comments

如果显示,讨论帖的优先评论。

字符串

桌面和移动端

items.source

托管该内容的平台或网站名称。

字符串

桌面和移动端

items.engagement_timeframe

评论数和活动时间范围(例如:“45 条评论,2 天前”)。

字符串

桌面和移动端

搜索信息

search_information 该功能提供关于搜索查询的结构化信息。

...
"search_information": {
    "query": "restaurants",
    "geo_location": "10007, New York, NY",
    "showing_results_for": "restaurants",
    "total_results_count": 3200000000
},
...
键 (results.search_information)
说明
类型
布局

query

原始搜索词。

字符串

桌面和移动端

geo_location *仅在启用 JS 渲染时有效

指示与搜索关联的特定地理区域。

字符串

桌面

showing_results_for

用于显示搜索结果的搜索词。如果 Google 自动纠正了提供的搜索词,`query` 与 `showing_results_for` 可能不同。

字符串

桌面和移动端

total_results_count

为搜索词找到的结果总数。

整数

桌面和移动端

项目轮播

一个轮播(item_carousel)在搜索结果页面最顶部展示与特定类型项目相关的图片或链接。内容和布局依用户查询不同而变化,展示一组选定的相关项目,范围可从产品与新闻到图片,营造视觉吸引且定制的用户体验。

...
"item_carousel": {
    "items": [
        {
            "pos": 1,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "哈利法塔 828\u00a0m, 到尖顶 830\u00a0m",
            "subtitle": "828m, 到尖顶 830m"
        },
        {
            "pos": 2,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Warisan Merdeka 塔 679\u00a0m",
            "subtitle": "679m"
        },
...
     ],
    "title": "建筑物(按高度)",
    "pos_overall": 1
},
...
键 (results.item_carousel)
说明
类型
布局

items

放置在轮播中的项目及其各自详情的列表。

数组

桌面

items.pos

项目在轮播中的位置。

整数

桌面

items.href

指向轮播中项目的 Google SERP 的超链接。

字符串

桌面

items.title

轮播中实体的名称/标题。

字符串

桌面

items.subtitle

标题中实体的附加详情。

字符串

桌面

title

轮播板块的标题。标题与搜索查询相关。

字符串

桌面

pos_overall

表示搜索结果页面中项目轮播结果的位置。

整数

桌面

食谱

recipes Google 的 SERP 功能在搜索结果顶部展示特定菜肴的烹饪说明、配料、评分和来源。

...
"recipes": {
    "items": [
        {
            "pos": 1,
            "url": "https://handletheheat.com/chewy-brownies/",
            "desc": "不加糖可可粉、巧克力豆、苏打粉、蛋黄、中筋面粉",
            "title": "有史以来最好吃的嚼劲布朗尼",
            "rating": 4.8,
            "source": "Handle the Heat",
            "duration": "45 分钟"
        },
...
    ],
    "pos_overall": 1
},
...
键 (results.recipes)
说明
类型
布局

items

所选食谱及其各自详细信息的列表。

数组

桌面和移动端

items.pos

食谱在 Recipes SERP 功能中的位置。

整数

桌面和移动端

items.url

完整食谱的 URL。

字符串

桌面和移动端

items.desc

从原始文章中提取的食谱简短描述。

字符串

桌面

items.title

食谱的标题。

字符串

桌面和移动端

items.rating

食谱的评分。

整数

桌面和移动端

items.source

食谱所在网站的名称。

字符串

桌面和移动端

items.duration

准备这道菜所需的时间。

字符串

桌面和移动端

pos_overall

表示 Recipes 结果在搜索结果页面中的位置。

整数

桌面和移动端

视频

videos Google 搜索结果页面中的一个功能,显示与用户查询相关的精选视频内容,包括缩略图、标题和来源信息。

...
"videos": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.youtube.com/watch?v=xFrGuyw1V8s",
            "title": "Abba - Dancing Queen (Official Music Video Remastered)",
            "author": "AbbaVEVO",
            "source": "YouTube"
        },
        {
            "pos": 2,
            "url": "https://www.youtube.com/watch?v=-crgQGdpZR0",
            "title": "ABBA - Take A Chance On Me (Official Music Video)",
            "author": "AbbaVEVO",
            "source": "YouTube"
        },
...
    ],
    "pos_overall": 4
},
...
键 (results.videos)
说明
类型
布局

items

包含所有视频部分结果的列表。

数组

桌面和移动端

items.pos

视频在列表中的位置。

整数

桌面和移动端

items.url

指向该视频的链接。

字符串

桌面和移动端

items.title

视频的标题。

字符串

桌面和移动端

items.author

上传该视频的个人资料名称。

字符串

桌面和移动端

items.source

托管该视频的平台名称。

字符串

桌面和移动端

pos_overall

表示 Videos 结果在搜索结果页面中的位置。

整数

桌面和移动端

特色摘要

featured_snippet 是一种独特的 Google 搜索结果,在链接到页面之前显示对该页面的简明描述。这些高亮结果显著显示在自然搜索结果的顶部,为用户提供快速访问相关信息的途径。

...
"featured_snippet": [
    {
        "url": "https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors",
        "desc": "随着秋季夜间时长增加,叶绿素的生成减缓然后停止,最终所有叶绿素被破坏。叶子中存在的类胡萝卜素和花青素随后被显现并呈现出颜色。",
        "title": "秋色科学 | 美国林务局",
        "url_shown": "https://www.fs.usda.gov\u203a visit \u203a science-of-fall-colors",
        "pos_overall": 1
    }
],
...
键 (results.featured_snippet)
说明
类型
布局

url

检索出该段描述页面的所示网站的 URL。

字符串

桌面和移动端

desc

包含特定搜索结果描述的摘录段落。

字符串

桌面和移动端

title

检索出该段描述页面的文章名称。

字符串

桌面和移动端

url_shown

在搜索结果页面中可见的特色摘要所在网站的 URL。

字符串

桌面和移动端

pos_overall

表示 Featured Snippet 结果在搜索结果页面中的位置。

整数

桌面和移动端

相关搜索(按类别)

related_searches_categorized 专门展示与列表相关的搜索。不同于包含所有用户查询的一般相关搜索,此功能提供聚焦于列表相关查询的结果。通常出现在搜索结果页面底部,作为与主要搜索词相关的关键词的目标来源。

...
"related_searches_categorized": [
    {
        "items": [
            {
                "url": "/search?sca_esv=589812617...",
                "title": "Bayerische Motoren Werke AG"
            },
            {
                "url": "/search?safe=off&sca_esv=588766249...",
                "title": "Mercedes..."
            },
           ...
        ],
        "category": {
            "name": "Electric car companies",
            "type": "expanded"
        },
        "pos_overall": 10
    },
...
键 (results.related_searches_categorized)
说明
类型
布局

items

包含从搜索结果页面水平轮播检索到的所有相关搜索项的列表。

数组

桌面

items.url

相关搜索页面的 URL。

字符串

桌面

items.title

在浏览器中呈现的相关搜索结果的名称。

字符串

桌面

类别

包含有关相关搜索结果类别的更多详细信息的对象。

对象

桌面

category.name

类别的名称。

字符串

桌面

category.type

相关搜索部分的类型。

字符串

桌面

pos_overall

表示 Related Searches Categorized 结果在搜索结果页面中的位置。

整数

桌面

酒店

Google hotels 是一个直接在搜索结果中展示酒店信息的功能。当用户在 Google 上搜索酒店或与住宿相关的查询时,搜索引擎可能在结果页面顶部呈现专门的酒店模块,提供相关选项的便捷概览。

...
"hotels": {
    "date_to": "周一, 12 月 11 日",
    "results": [
        {
            "price": "£54",
            "title": "希尔顿花园酒店 维尔纽斯市中心",
            "description": "现代酒店,设有餐厅/酒吧"
        },
        {
            "price": "£57",
            "title": "丽笙布鲁酒店 Lietuva",
            "description": "现代高层,设有水疗和餐饮"
        },
       ...
    ],
    "date_from": "周日, 12 月 10 日",
    "pos_overall": 5
},
...
键 (results.hotels)
说明
类型
布局

date_to

退房日期。

字符串

桌面

results

包含所有酒店详细信息的列表。

数组

桌面

results.price

酒店的价格。

字符串

桌面

results.title

酒店的名称。

字符串

桌面

results.description

显示在酒店名称下方的简短描述。

字符串

桌面

date_from

入住日期。

字符串

桌面

pos_overall

表示 Hotels 结果在搜索结果页面中的位置。

整数

桌面

航班

flights 该功能展示与相关搜索查询相关的组织化航班选项模块,允许用户在搜索结果中直接比较选项。

...
"flights": {
    "to": "伦敦,英国(所有机场)",
    "from": "纽约,纽约(所有机场)",
    "date_to": "周一, 1 月 29 日",
    "results": [
        {
            "url": "https://www.google.com/travel/flights?safe=off&sca_esv=590053957&source=flun&uitype=cuAA&hl=en&gl=us&curr=USD&tfs=CAEQAhotEgoyMDI0LTAxLTIyMgJaMGoNCAISCS9tLzAyXzI4NnIMCAISCC9tLzA0anBsGi0SCjIwMjQtMDEtMjkyAlowagwIAhIIL20vMDRqcGxyDQgCEgkvbS8wMl8yODZ6aENqUklUVmxrYjA1V2RubE9kazFCUkRSM2RrRkNSeTB0TFMwdExTMHRMWGxzWm5FeU9FRkJRVUZCUjFZMFNrMXpTVXhTTTJ0QkVnTnVXakFhQ3dpOHlnSVFBaG9EVlZORU9EQnd2TW9D",
            "type": "直飞",
            "price": "$423",
            "airline": "Norse Atlantic UK",
            "duration": "6 小时 50 分钟"
        },
       ...
    ],
    "date_from": "周一, 1 月 22 日",
    "pos_overall": 1
},
...
键 (results.flights)
说明
类型
布局

到达

到达机场。

字符串

桌面和移动端

出发

出发机场。

字符串

桌面和移动端

date_to

到达的日期。

字符串

桌面和移动端

results

所选航班及其各自详细信息的列表。

数组

桌面和移动端

results.url

列出单一航空公司所有航班的 Google Flights 页面链接。

字符串

桌面和移动端

results.type

航班的类型。

字符串

桌面

results.price

航班的价格。

字符串

桌面和移动端

results.airline

航空公司的名称。

字符串

桌面和移动端

results.duration

航班的飞行时长。

字符串

桌面和移动端

date_from

出发日期。

字符串

桌面和移动端

pos_overall

表示 Flights 结果在搜索结果页面中的位置。

整数

桌面和移动端

视频框

video_box 该功能在搜索结果页面顶部突出显示一个特定的视频结果,该视频由 Google 选择为与查询最相关的结果。

...
"video_box": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
    "pos_overall": 1
},
...
键 (results.video_box)
说明
类型
布局

url

视频的 URL。

字符串

桌面和移动端

title

视频的标题。

字符串

桌面和移动端

pos_overall

表示 Video Box 结果在搜索结果页面中的位置。

整数

桌面和移动端

本地服务广告

local_service_ads 该功能使以服务为导向的专业人员(如水管工、电工、锁匠以及其他本地服务提供商)能够在 Google 搜索结果页面上推广其服务。

...
"local_service_ads": {
    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall & Katt, 律师事务所",
            "rating": 4.4,
            "reviews_count": 254,
            "google_guaranteed": true
        },
       ...
    ],
    "pos_overall": 2
},
...
键 (results.local_service_ads)
说明
类型
布局

items

服务提供商及其各自详情的列表。

数组

桌面

items.pos

服务广告在 Local Services Ads SERP 功能中的位置。

整数

桌面

items.url

指向本地服务搜索页面中该服务的链接。

字符串

桌面

items.title

服务提供商的标题/名称。

字符串

桌面

items.rating

服务提供商的评分。

整数

桌面

items.reviews_count

服务提供商的评论数量。

整数

桌面

items.google_guaranteed

Google 徽章,颁发给通过 Google 审核和验证流程的企业。可用值为 "true" 或 "false"。

boolean

桌面

pos_overall

表示 Local Service Ads 结果在搜索结果页面中的位置。

整数

桌面

应用

apps SERP 功能根据用户查询展示相关应用,提供价格、评分等关键细节。此功能为应用开发者和发行者在 Google 搜索结果页面上提升其移动应用的可见性和参与度提供了有价值的平台。

...
"apps": [
    {
        "id": "com.instagram.android",
        "url": "https://play.google.com/store/apps/details?id=com.instagram.android&hl=en_US&gl=US&referrer=utm_source%3Dgoogle%26utm_medium%3Dorganic%26utm_term%3Dinstagram&pcampaignid=APPU_1_WsivZdzUFMbZ1sQPrf-yoAU",
        "title": "Instagram",
        "rating": "4.4",
        "reviews_count": "151M"
    }
],
...
键 (results.apps)
说明
类型
布局

id

应用在可用应用商店中的 id。

字符串

移动端

url

在搜索结果中包含关于该应用的完整信息的应用商店 URL。

字符串

移动端

title

应用的标题。

字符串

移动端

rating

应用的评分。

整数

移动端

reviews_count

应用商店中 Apps SERP 结果的评论总数。

整数

移动端

items.reviews_count

服务提供商的评论数量。

字符串

移动端

财经

公司财务数据摘要,包括股票价格、市值和其他关键指标。

HTML 示例

键 (results.finance)
说明
类型
布局

最低

指定日期的最低价格。

float

桌面

日期

报告净资产价值的日期。

字符串

桌面

最高

指定日期的最高价格

float

桌面

开盘价

指定日期的开盘价

float

桌面

source

相关 Google Finance 来源网站的 URL。

字符串

桌面

差额

最近报告的净资产值与前一次报告的变动。

字符串

桌面

市值

公司已发行流通股的总美元价值

字符串

桌面

股票名称

股票的名称。

字符串

桌面

52 周最低

52 周最低价

float

桌面

52 周最高

52 周最高价

float

桌面

当前价格

实时价格报价。

字符串

桌面

股息收益率

每股股息除以每股价格所得到的股息–价格比率

float

桌面

市盈率

股票的市盈率

float

桌面

JSON 示例

...                   
"finance": {
    "low": 157.51,
    "date": "4 月 25 日,上午 8:09 EDT",
    "high": 167.97,
    "open": 162.84,
    "source": "https://www.google.com/finance/quote/TSLA:NASDAQ?sa=X&ved=2ahUKEwjl29u-qt2FAxWFLbkGHUyiCt0Q3ecFegQIfhAX",
    "difference": "+17.45 (12.06%)",
    "market_cap": "508.03B",
    "stock_name": "NASDAQ: TSLA",
    "52_week_low": 138.8,
    "52_week_high": 299.29,
    "current_price": "162.13 USD",
    "dividend_yield": 0,
    "price_earnings_ratio": 41.47
},
...

体育比赛

有关近期体育比赛的信息,详细说明比分、队伍、比赛类型和亮点。

HTML 示例

键 (results.sports_games)
说明
类型
布局

比赛

提供若干体育比赛信息的数组

数组

桌面

games.date

比赛安排进行或发生的日期和时间

字符串

桌面

games.teams

参加比赛的队伍

数组

桌面

games.game_type

比赛的类型,例如常规赛、季后赛、冠军赛等。

字符串

桌面

games.highlight

指向比赛精彩片段的链接,如关键回合、进球等。

字符串

桌面

games.teams.score

每支球队在比赛中获得的比分或得分

字符串

桌面

games.teams.winner

指定哪支球队赢得了比赛

boolean

桌面

games.teams.team_name

显示参加比赛队伍的名称

字符串

桌面

阶段

体育赛事或锦标赛的具体阶段或分级。

字符串

桌面

联赛

指监督该比赛的体育联赛或组织

字符串

桌面

JSON 示例

...                 
"sports_games": {
    "games": [
  		...
                {
            "date": "昨天",
            "teams": [
                {
                    "score": "75",
                    "winner": false,
                    "team_name": "巴塞罗那"
                },
                {
                    "score": "77",
                    "winner": true,
                    "team_name": "奥林匹亚科斯"
                }
            ],
            "game_type": "决赛",
            "highlight": "https://stories.euroleague.net/games/329003-20240424-Barcelona-vs-Olympiacos-Piraeus.html"
        },
    				...
    ],
    "stage": "四分之一决赛",
    "league": "欧洲联赛"
},
...

讨论和论坛

包含带有 URL、标题、来源和评论数的讨论线程和论坛帖子的清单。

HTML 示例

键 (results.discussions_and_forums)
说明
类型
布局

items

Google 已索引的论坛或讨论主题中的条目数组

数组

桌面

items.pos

表示某项在所有讨论与论坛结果中位置的指示器。

整数

桌面

items.url

特定论坛帖子或讨论主题的 URL 链接

字符串

桌面

items.title

论坛帖子或讨论主题的标题或标题行

字符串

桌面

items.source

托管该论坛或讨论的来源

字符串

桌面

items.timeframe

论坛帖子或讨论的时间范围或日期

字符串

桌面

items.comments_count

论坛帖子或讨论主题收到的评论或回复数量

字符串

桌面

pos_overall

表示 Discussions and Forums SERP 功能在搜索结果页面中的位置。

整数

桌面

JSON 示例

...
"discussions_and_forums": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.reddit.com/r/webscraping/comments/y4v5ws/free_http_proxy/",
            "title": "免费 HTTP 代理? : r/webscraping - Reddit",
            "source": "Reddit",
            "timeframe": "1 年",
            "comments_count": "20+ 条评论"
        },
        ...
    ],
    "pos_overall": 7
}
},
...

最后更新于

这有帮助吗?