# 网页搜索 该 `google_search` 源用于检索 Google Search（SERPs）和 Google AI Overviews 结果。此子页面专门展示与 Google Web Search 相关的信息。要查看其他结果类型，请阅读 [**图片搜索**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/targets/google/search/image-search) 或[ **新闻搜索**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/targets/google/search/news-search). ## 请求示例 在下面的示例中，我们发起一个请求以获取 `2` 结果页，从第 `11` 到第 `12` 页，搜索词为 `adidas`。SERP 将被过滤为仅包含法语结果。API 将返回已解析的结果。 {% tabs %} {% tab title="cURL" %} ```shell curl 'https://realtime.oxylabs.io/v1/queries' \ --user 'USERNAME:PASSWORD' \ -H 'Content-Type: application/json' \ -d '{ "source": "google_search", "query": "adidas", "start_page": 11, "pages": 2, "parse": true, "context": [ { "key": "results_language", "value": "fr" } ] }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # Structure payload. payload = { 'source': 'google_search', 'query': 'adidas', 'start_page': 11, 'pages': 2, 'parse': True, 'context': [ {'key': 'results_language', 'value': 'fr'}, ], } # Get response. response = requests.request( 'POST', 'https://realtime.oxylabs.io/v1/queries', auth=('USERNAME', 'PASSWORD'), json=payload, ) # Print prettified response to stdout. pprint(response.json()) ``` {% endtab %} {% tab title="Node.js" %} ```javascript const https = require("https"); const username = "USERNAME"; const password = "PASSWORD"; const body = { source: "google_search", query: "adidas", start_page: 11, pages: 2, parse: true, context: [ { key: "results_language", value: "fr" }, ], }; const options = { hostname: "realtime.oxylabs.io", path: "/v1/queries", method: "POST", headers: { "Content-Type": "application/json", Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"), }, }; const request = https.request(options, (response) => { let data = ""; response.on("data", (chunk) => { data += chunk; }); response.on("end", () => { const responseData = JSON.parse(data); console.log(JSON.stringify(responseData, null, 2)); }); }); request.on("error", (error) => { console.error("Error:", error); }); request.write(JSON.stringify(body)); request.end(); ``` {% endtab %} {% tab title="HTTP" %} ```http https://realtime.oxylabs.io/v1/queries?source=google_search&query=adidas&start_page=11&pages=2&parse=true&context[0][key]=results_language&context[0][value]=fr&access_token=12345abcde ``` {% endtab %} {% tab title="PHP" %} ```php 'google_search', 'query' => 'adidas', 'start_page' => 11, 'pages' => 2, 'parse' => true, 'context' => [ [ 'key' => 'results_language', 'value' => 'fr', ] ] ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD"); $headers = array(); $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); ``` {% endtab %} {% tab title="Golang" %} ```go package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { const Username = "USERNAME" const Password = "PASSWORD" payload := map[string]interface{}{ "source": "google_search", "query": "adidas", "start_page": 11, "pages": 2, "parse": true, "context": []map[string]interface{}{ {"key": "results_language", "value": "fr"}, }, } jsonValue, _ := json.Marshal(payload) client := &http.Client{} request, _ := http.NewRequest("POST", "https://realtime.oxylabs.io/v1/queries", bytes.NewBuffer(jsonValue), ) request.SetBasicAuth(Username, Password) response, _ := client.Do(request) responseText, _ := ioutil.ReadAll(response.Body) fmt.Println(string(responseText)) } ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Collections.Generic; using System.Net.Http; using System.Net.Http.Json; using System.Threading.Tasks; namespace OxyApi { class Program { static async Task Main() { const string Username = "USERNAME"; const string Password = "PASSWORD"; var parameters = new { source = "google_search", query = "adidas", start_page = 11, pages = 2, parse = true, context = new dynamic [] { new { key = "results_language", value = "fr" }, } }; var client = new HttpClient(); Uri baseUri = new Uri("https://realtime.oxylabs.io"); client.BaseAddress = baseUri; var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries"); requestMessage.Content = JsonContent.Create(parameters); var authenticationString = $"{Username}:{Password}"; var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString)); requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString); var response = await client.SendAsync(requestMessage); var contents = await response.Content.ReadAsStringAsync(); Console.WriteLine(contents); } } } ``` {% endtab %} {% tab title="Java" %} ```java package org.example; import okhttp3.*; import org.json.JSONArray; import org.json.JSONObject; import java.util.concurrent.TimeUnit; public class Main implements Runnable { private static final String AUTHORIZATION_HEADER = "Authorization"; public static final String USERNAME = "USERNAME"; public static final String PASSWORD = "PASSWORD"; public void run() { JSONObject jsonObject = new JSONObject(); jsonObject.put("source", "google_search"); jsonObject.put("query", "adidas"); jsonObject.put("start_page", 11); jsonObject.put("pages", 2); jsonObject.put("parse", true); jsonObject.put("context", new JSONArray() .put(new JSONObject() .put("key", "results_language") .put("value", "fr")) ); Authenticator authenticator = (route, response) -> { String credential = Credentials.basic(USERNAME, PASSWORD); return response .request() .newBuilder() .header(AUTHORIZATION_HEADER, credential) .build(); }; var client = new OkHttpClient.Builder() .authenticator(authenticator) .readTimeout(180, TimeUnit.SECONDS) .build(); var mediaType = MediaType.parse("application/json; charset=utf-8"); var body = RequestBody.create(jsonObject.toString(), mediaType); var request = new Request.Builder() .url("https://realtime.oxylabs.io/v1/queries") .post(body) .build(); try (var response = client.newCall(request).execute()) { if (response.body() != null) { try (var responseBody = response.body()) { System.out.println(responseBody.string()); } } } catch (Exception exception) { System.out.println("Error: " + exception.getMessage()); } System.exit(0); } public static void main(String[] args) { new Thread(new Main()).start(); } } ``` {% endtab %} {% tab title="JSON" %} ```json { "source": "google_search", "query": "adidas", "start_page": 11, "pages": 2, "parse": true, "context": [ { "key": "results_language", "value": "fr" } ] } ``` {% endtab %} {% endtabs %} 我们的示例使用同步 [**Realtime**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/realtime) 集成方法。如果您想使用 [**Proxy Endpoint**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/proxy-endpoint) 或异步 [**Push-Pull**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/push-pull) 集成，请参阅 [**集成方法**](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods) 部分。 ## 请求参数值 ### 通用 抓取 Google Web 搜索结果的基本设置和自定义选项。
参数说明默认值
source设置爬虫。google_search
query要搜索的关键词或短语。-
render当设置为 html. 时启用 JavaScript 渲染.-
parse当设置为 true时返回已解析数据。查看输出 数据字典.false
callback_url回调端点的 URL。 时启用 JavaScript 渲染.-
user_agent_type设备类型和浏览器。完整列表可见 此处.desktop
\- 必填参数 #### Google 高级搜索运算符 在抓取时，将 Google 高级搜索运算符与查询结合使用可能很有用。它可以让您自定义搜索范围，确保结果更相关、更聚焦。探索这些特殊命令 [**此处**](https://ahrefs.com/blog/google-advanced-search-operators/) 和 [**此处**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators)。请参见下面的示例。 ```json { "source": "google_search", "query": "iphone 15 launch inurl:apple", } ``` ### 本地化 将搜索结果适配到特定地理位置、地区和语言。
参数说明默认值
geo_location结果应适配到的地理位置。正确使用此参数对于获取正确数据极其重要。有关更多信息，请阅读我们建议的 geo_location 参数结构 此处.-
localeAccept-Language header value which changes your Google search page web interface language. 时启用 JavaScript 渲染.-
context:
results_language		结果语言。支持的 Google 语言列表可见 此处.
了解如何使用上下文参数 此处.		-
### 分页 用于管理搜索结果分页和检索的控制项。
参数说明默认值
start_page起始页码。1
pages要检索的页数。1
limit每页要检索的结果数。10
context:limit_per_page使用相同的 IP 地址和会话（cookie 集）抓取多页。通过在 JSON 数组中指定页面编号，并使用 page 键，且使用 limit 键指示每页自然结果的数量，您可以最大限度地减少跨页出现重叠自然结果的可能性（例如，第一页的最后一个自然结果与第二页的第一个自然结果相同）。 查看示例.-
#### 支持连续滚动 Web Scraper API 完全支持 Google Search 连续滚动。它会自动检测连续滚动布局，高效加载所请求的自然结果，无需任何额外参数。 #### 每页限制 {% hint style="warning" %} 由于 Google 最近的限制变更，我们已调整 Web Scraper API 的行为。每页最大结果数将与 Google 的自然结果输出一致，通常为 10 条结果。 {% endhint %} 要使用此功能，请包含一个 JSON 数组，其中包含以下数据的 JSON 对象：
参数说明示例
page您想抓取的页面编号。任何大于 0 的整数值都可以1
limit相关页面上的结果数。介于 1 和 100 （含）之间的任何整数值都可以。90
#### 请求示例 ```json { "source": "google_search", "query": "adidas", "parse": true, "context": [ { "key": "limit_per_page", "value": [ {"page": 1, "limit": 10}, {"page": 2, "limit": 90} ] }] } ``` ### 过滤 根据各种条件过滤和细化搜索结果的选项。了解如何使用上下文参数 [**此处**](#context-parameters).
参数说明默认值
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 值下可用 app）。更多信息 此处.-
{% hint style="warning" %} `udm` 和 `tbm` 上下文参数不能在单个抓取请求中同时使用；请选择其中一个。同时使用可能会导致冲突或意外行为。 {% endhint %} ### 其他 针对特殊需求的附加高级设置和控制。
参数说明默认值
context:
fpstate		将 fpstate 值设为 aig 会让 Google 加载更多应用。此参数仅在与 render 参数一起使用时有用。-
context:
nfpr		true 将关闭拼写自动更正false
### 上下文参数 所有上下文参数都应作为对象添加到 `context` 数组中，使用 `key` 和 `值下可用` 键值对，例如： ```json ... "context": [ { "key": "filter", "value": "0" } ] ... ``` ## 结构化数据 Web Scraper API 能够提取包含 Google 搜索结果的 HTML 或 JSON 对象，并提供结果页各元素的结构化数据。
google_search 结构化输出 ```json { "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": "adidas 的图片结果", "pos": 1, "url": "/search?q=adidas&gl=us&h...E#imgrc=Dw-CBW17i8BqsM", "source": "https://www.britannica.com/topic/Adidas-AG" }, { "alt": "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 Official Website | adidas US", "sitelinks": { "expanded": [ { "url": "https://www.adidas.com/us/women", "title": "女装" }, { "url": "https://www.adidas.com/us/sale", "title": "促销" } ] }, "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 - 不止是购物应用 运动和运动鞋的家，adidas 应用让您更接近精彩时刻，可访问球鞋发售、...大小：115M 更新：2022年5月3日 评分：4.8 · ‎322,391 次投票 · ‎免费 · ‎Android · ‎体育", "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": "你在锻炼时最喜欢听什么？", "timeframe": "5 days ago" }, { "pos": 3, "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet", "content": "你会如何向外星人描述你最喜欢的运动？", "timeframe": "Apr 27, 2022" } ], "title": "", "pos_overall": 7 }, "knowledge": { "title": "Adidas", "factoids": [ { "title": "客服聊天", "content": "在线聊天" }, { "title": "网站", "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": "设计公司", "description": "Adidas AG 是一家德国跨国公司，成立并总部位于巴伐利亚州黑措根奥拉赫，设计和制造鞋类、服装和配饰。它是欧洲最大的运动服制造商，也是全球第二大，仅次于 Nike。", "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 舒适拖鞋 - 米色 | 女士游泳 | adidas 美国", "source": "", "timeframe": "8 小时前" }, { "pos": 3, "url": "https://www.adidas.com/us/women-clothing-sale", "title": "女士服装最高 5 折优惠 | adidas 美国", "source": "", "timeframe": "2021 年 9 月 30 日" } ], "pos_overall": 3 }, "instant_answers": [ { "type": "未知", "_parsed": false, "pos_overall": 5 } ], "popular_products": { "items": [ { "pos": 1, "title": "Adidas Yeezy Kids Foam Runner", "image_data": "UklGRhwJAABXRUJQVlA...rAZNVIAAA" }, { "pos": 10, "title": "Adidas 男士 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" } ] } ```
{% hint style="info" %} 元素的组成可能会因是否为 **desktop** 或 **移动端** 搜索而有所不同。 {% endhint %} 为帮助你识别某些元素，请参考每种 Google 搜索结果类型的数据字典，无论它们来自桌面端还是移动端搜索。 ## 输出数据字典 可通过右侧导航或向下滚动页面查看详细信息。 **HTML 示例**
#### **JSON 结构** Google Web Search 的结构化输出包含诸如 `URL`, `page`, `results`等字段。下表列出了我们解析的每个 SERP 功能的详细信息，包括其描述和数据类型。表格还包含一些元数据。 {% hint style="info" %} 特定结果类型的项目和字段数量可能会因搜索查询而异。 {% endhint %}
键名说明类型
urlGoogle 搜索页面的 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_boxesSERP 中的视频框及其各自详细信息。数组
results.recipes包含各自详细信息的食谱列表。对象
results.twitter包含各自详细信息的 Twitter (X) 结果列表。数组
results.knowledge从知识面板获取的相关信息列表。对象
results.local_pack包含与搜索相关的本地商家列表。对象
results.item_carousel针对信息查询的说明性项目列表及其各自详细信息。对象
results.videos包含各自详细信息的视频列表。对象
results.hotels与搜索查询中使用的位置相关的酒店列表。对象
results.apps包含各自详细信息的应用列表。数组
results.finance公司的财务数据摘要，包括股价、市值和其他关键指标。对象
results.sports_games近期体育比赛信息，详细说明比分、球队、比赛类型和亮点。对象
results.discussions_and_forums带有 URL、标题、来源和评论数的讨论线程和论坛帖子列表。对象
results.featured_snippet从 SERP 的自然结果部分检索到的特定结果列表。数组
results.top_stories当搜索查询被识别为新闻导向时，显示其各自详细信息的文章列表。对象
results.popular_productsGoogle Shopping 商品列表的未付费和自然展示列表及其各自详细信息。对象
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抓取任务创建时的时间戳。timestamp
updated_at抓取任务完成时的时间戳。timestamp
job_id与抓取任务关联的任务 ID。字符串
status_code抓取任务的状态码。你可以查看已描述的抓取器状态码 此处.整数
parser_type用于拆分 HTML 内容的解析器类型。字符串
{% hint style="info" %} 在以下部分中，当某种结果类型有多个项目时，已解析的 JSON 代码片段会进行截断。 {% endhint %} ### 商品列表广告 (PLA) 该 `pla` 搜索结果部分指的是商品列表广告，也称为 Google Shopping 广告，通常以轮播形式显著显示在搜索页面顶部。
```json ... "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 最新款，配黄色和蓝色手柄 Wildcat 套装（包含 2000 V-Bucks 和 Wildcat 套装兑换码），6.2\" 触摸屏 LCD 显示屏，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 支持的广告，通常显示在自然（未付费）结果上方。
```json ... "paid": [ { "pos": 1, "url": "https://www.adidas.com/us/cyber_monday", "desc": "最后机会抢购 Cyber 优惠。使用代码 CYBERSALE，精选商品和正价商品额外 55 折。今天就访问 adidas® 官方网站。加入我们的 adiClub 会员计划。仅限会员奖励。adiClub 独家优惠。", "title": "adidas 官方网站 | 额外 55 折 | 代码 CYBERSALE", "data_rw": "https://www.google.com/aclk?...", "sitelinks": { "expanded": [ { "url": "https://www.adidas.com/us/shop", "desc": "最后机会抢购 Cyber 优惠。使用代码 CYBERSALE 额外 55 折。", "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 › official › 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表示付费结果在 SERP 中的位置。整数桌面端和移动端
### 图片 该 `images` 该部分指在 SERP 页面不同区域显示的图片结果，既可能是单独区域，也可能在顶部。需要注意的是，从 Google Search 结果抓取的数据结构可能不同于从 Google Image Search 结果抓取的数据结构。
```json ... "images": { "items": [ { "alt": "Adidas | 历史、产品与事实 | Britannica", "pos": 1, "url": "https://www.britannica.com/topic/Adidas-AG" }, { "alt": "Superstar x Indigo Herz 鞋款", "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图片的替代文本。字符串桌面端和移动端
items.pos表示图片在列表中位置的唯一标识。整数桌面端和移动端
items.url包含图片的网页 URL。字符串桌面端和移动端
pos_overall表示 Images SERP 功能在 SERP 中的位置。整数桌面端和移动端
### 自然结果 该 `organic` 该部分指 Google 自然搜索结果中的未付费列表，由 Google 算法根据相关性决定。这些列表显示在搜索页面的付费广告下方。 #### 示例 1
```json ... "organic": [ { "pos": 1, "url": "https://www.loveandlemons.com/brownies-recipe/", "desc": "最棒的布朗尼配方！使用可可粉和巧克力碎制作，这些自制布朗尼湿润、软糯、超级巧克力风味，而且很容易做！", "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› 食谱", "pos_overall": 2 }, ... ``` #### 示例 2
```json ... "organic": [ { "pos": 9, "pos_overall": 13, "title": "Classics 冬季运动夹克 - 军绿色", "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket", "url_shown": "https://www.reebok.com› classics-winter-track-jacket", "desc": "一款柔软的 sherpa 运动夹克，灵感源自户外冬季运动 · 宽松版型，轻松休闲，完全不受束缚 · 面料：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", "有库存", "3.9(7)", "满 75 美元免运费", "30 天内免费退货" ] }, ... ```
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 结果在 SERP 中的位置。整数桌面端和移动端
favicon_text与 favicon（网站图标）关联的文本或名称。字符串桌面端
rating商品或内容的平均评分。浮点数桌面端
review_count与商品或内容相关的评论数量。整数桌面端
additional_info包含价格、可用性、商品评分、配送选项、退货政策等详细信息。字符串列表桌面端
### 自然视频 该 `results.organic_videos` 包含在搜索结果中以自然方式展示的视频列表，也就是非付费广告。每个视频条目都包含视频标题、URL、描述等相关详细信息。
```json ... "organic_videos": [ { "pos": 1, "url": "https://www.youtube.com/watch?v=XHTrLYShBRQ", "desc": "你的浏览器无法播放此视频。了解更多。", "title": "Introducing iPhone 15 | WOW | Apple - YouTube", "pos_overall": 6 }, ... ```
results.organic_videos 的键说明类型布局
pos表示某个项目在自然视频结果中的位置。整数桌面端
url视频的 URL。字符串桌面端
desc视频的简短描述。字符串桌面端
title视频的标题。字符串桌面端
pos_overall表示 Organic Video 结果在 SERP 中的位置。整数桌面端
### 热门景点 该 `results.top_sights` 包含通常与搜索位置或主题相关的著名地标或景点列表。每个项目都包括列表中的位置和标题等详细信息。
```json ... "top_sights": { "items": [ { "pos": 1, "title": "维尔纽斯大教堂" }, { "pos": 2, "title": "格迪米纳斯城堡塔" }, { "pos": 3, "title": "黎明之门" } ], "pos_overall": 1 }, ... ```
results.top_sights 的键说明类型布局
items包含各自详细信息的热门景点列表。数组桌面端
items.posTop Sights 结果在 Top Sights SERP 功能中的位置。整数桌面端
items.title旅游景点的标题。字符串桌面端
pos_overall表示 Top Sights 结果在 SERP 中的位置。整数桌面端
### 职位 该 `results.jobs` 包含从搜索结果中提取的职位列表。每个列表都包括指向职位发布的 URL、职位标题、来源、雇主和地点等详细信息。这些列表来自各种招聘网站、职业网站以及被 Google 索引的其他平台。
```json ... "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": "通过 LinkedIn", "employer": "Men's & Fathers' Rights Divorce Lawyers, Schultz & Associates, LLC", "location": "美国" }, ... ], "pos_overall": 1 }, ... ```
results.jobs 的键说明类型布局
listings页面中可用的所有职位列表数组。数组桌面端
listings.url完整职位列表的 URL。字符串桌面端
listings.title职位名称。字符串桌面端
listings.source包含原始职位发布的来源。字符串桌面端
listings.employer招聘该职位的组织。字符串桌面端
listings.location该职位所在地点。字符串桌面端
pos_overall表示 Jobs SERP 功能在 SERP 中的位置。整数桌面端
### Twitter (X) 该 `twitter` 此功能常出现在品牌、电影、音乐人和其他名人的搜索结果中，通常位于品牌网站搜索结果下方。此功能提供指向品牌 Twitter 动态的直接链接，并展示其最新推文的轮播。
```json ... "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 下午 5 点 PT。#NintendoSwitchOnline #MissionsAndRewards\n\n了解更多：ninten.do/6017iHF1b", "timeframe": "12 小时前" }, ... ], "title": "Nintendo of America (@NintendoAmerica) · X", "pos_overall": 4 }, ... ```
results.twitter 的键说明类型布局
pos表示某个项目在自然结果中的位置。整数桌面端
url包含 Twitter (X) 帖子的个人资料 URL。字符串桌面端
items包含各自详细信息的 Twitter (X) 帖子列表。数组桌面端
items.pos表示某条推文在 Twitter (X) SERP 功能中的位置。字符串桌面端
items.urlTwitter (X) 帖子的 URL。字符串桌面端
items.content表示相关 Twitter (X) 帖子全部文本的简短描述。字符串桌面端
items.timeframe描述推文创建于多久之前。字符串桌面端
titleTwitter (X) 个人资料的标题。字符串桌面端
pos_overall表示 Twitter 结果在 SERP 中的位置。整数桌面端
### 知识 该 `knowledge` 搜索结果中的该部分会在搜索人物、地点、组织或已集成到 Knowledge Graph 的实体时，在右侧显示 Google 知识面板数据。
```json ... "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": "DescriptionAdidas AG 是一家德国运动服和鞋类公司，总部位于德国巴伐利亚州黑措根奥拉赫。它是欧洲最大的运动服制造商，也是全球第二大，仅次于 Nike。Wikipedia", "related_searches": [ { "url": "/search?safe=off&sca_esv=586315320...", "title": "Nike", "section_title": "大家还搜索" }, ... ] }, ... ```
results.knowledge 的键说明类型布局
title知识面板的标题。字符串桌面端和移动端
images紧邻标题使用的图片列表。数组桌面端
factoids知识面板中使用的所有事实列表。数组桌面端和移动端
factoids.links与给定事实项相关的所有链接列表。数组桌面端和移动端
factoids.links.href指向该事实对应的 Google 搜索结果页面的超链接。字符串桌面端和移动端
factoids.links.title与该事实条目相关的任何链接页面的描述。字符串桌面端和移动端
factoids.title事实条目部分的名称。字符串桌面端和移动端
factoids.content该事实条目的描述。字符串桌面端和移动端
profiles知识面板中列出的社交媒体资料列表。字符串桌面端
profiles.url指向该社交媒体资料的链接。字符串桌面端
profiles.title社交媒体资料的标题。字符串桌面端
副标题对标题中所述实体的简短说明。字符串桌面端和移动端
描述表示知识面板中该实体主要信息的描述。字符串桌面端和移动端
related_searches相关搜索及其各自详情的列表。数组桌面端
related_searches.url相关搜索页面的 URL。字符串桌面端
related_searches.title相关搜索页面的标题。字符串桌面端
related_searches.section_title相关搜索部分的名称。字符串桌面端
### 本地结果包 该 `local_pack` 根据用户位置或指定搜索位置显示排名前三的本地搜索结果，包括地图和附加信息。
```json ... "local_pack": { "items": [ { "cid": "1100080596967423812", "pos": 1, "title": "Pizza Hut", "rating": 3.8, "address": "Independence, KS", "subtitle": "Pizza", "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本地结果包结果在 SERP 中的位置指示。整数桌面端和移动端
### 热门新闻 `top_stories` 当搜索与新闻相关的查询时，会在 Google 搜索中显示的专门区域。
```json ... "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》抱怨11小时前", "source": "The Independent", "timeframe": "11 小时前" }, ... ], "pos_overall": 3 }, ... ```
键（results.top_stories）说明类型布局
items精选新闻文章及其各自详情的列表。数组桌面端和移动端
items.pos文章在热门新闻 SERP 功能中的位置。整数桌面端和移动端
items.url完整文章的 URL。字符串桌面端和移动端
items.title文章标题。字符串桌面端和移动端
items.section热门新闻部分的名称。字符串移动端
items.source文章发布所在网站的名称。字符串桌面端和移动端
items.timeframe描述文章发表于多久之前。字符串桌面端
pos_overall表示热门新闻 SERP 功能在 SERP 中的整体位置。整数桌面端和移动端
### 热门商品 该 `popular_products` SERP 功能会展示一个由多种商品组成的轮播，依据商品受欢迎程度和与用户查询的相关性确定。它不同于受广告商影响的商品列表广告（PLA）。值得注意的是，单个 SERP 页面上可能出现多个 `popular_products` 轮播。\\
```json ... "popular_products":[ { "items":[ { "pos":1, "price":"$109.99", "title":"adidas Gazelle 男款", "seller":"Footlocker.de", "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..." }, { "pos":2, "price":"$120.00", "title":"男款 adidas Gazelle 鞋", "rating":"4.9", "seller":"JD Sports Deutschland", "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..." }, ... ], "pos_overall":4 }, ... ] ... ```
键（results.popular_products）说明类型布局
items热门商品及其各自详情的列表。数组桌面端和移动端
items.pos用于表示某个热门商品在热门商品 SERP 功能中的位置的唯一标识。整数桌面端和移动端
items.price某个热门商品的价格。字符串桌面端和移动端
items.title某个热门商品的标题。字符串桌面端和移动端
items.rating某个热门商品的评分。字符串桌面端
items.seller某个热门商品的卖家。字符串桌面端
items.image_data商品的 base64 编码缩略图。字符串桌面端
pos_overall表示热门商品 SERP 功能在 SERP 中的整体位置。整数桌面端和移动端
### 相关搜索 该 `related_searches` SERP 功能显示与初始搜索关键词相关的替代搜索查询，通常位于 SERP 底部。
```json "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` 当搜索结果中有来自论坛、社交媒体或社区平台的相关帖子时，会显示在主搜索结果下方。该部分通常展示 Reddit、TikTok 和其他讨论论坛等平台的内容。
```json ... "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": "世界上排名第一的书是哪本？" }, ... ], "pos_overall": 2 }, ... ```
键（results.related_questions）说明类型布局
items包含所有相关问题的列表。数组桌面端和移动端
items.pos表示任一相关问题在相关问题 SERP 功能中的位置的唯一标识。整数桌面端和移动端
items.answer相关问题的答案。字符串桌面端和移动端
items.source包含描述问题答案来源的值。对象桌面端和移动端
items.source.url用于获取答案的网站 URL。字符串桌面端
items.source.title包含答案的网站标题。字符串桌面端
items.source.url_shown答案下方显示的简短 URL。字符串桌面端和移动端
items.question相关问题部分中的问题。字符串桌面端和移动端
pos_overall表示相关问题 SERP 功能在 SERP 中的整体位置。整数桌面端和移动端
### 大家在说什么 该 `what_people_are_saying` 当与搜索查询相关的论坛、社交媒体或社区平台中存在相关帖子时，此部分会出现在 Google 搜索结果中。此部分通常显示来自 Reddit、TikTok 和其他讨论论坛等平台的内容。
```json ... "what_people_are_saying": { "items": [ { "pos": 1, "url": "https://www.reddit.com/r/travel/comments/1kxf875/san_francisco_hotels/", "title": "旧金山酒店", "top_comments": "欢迎来到旧金山！有几点说明。\n* 10 月通常是我们一年中天气最好的时候。好计划！(任何读到这条的人：旧金山的“夏天”通常非常非常多雾而且寒冷。)\n*（这可能很明显，所以先致歉。也许对其他读到这条的人会有帮助。）49 人队实际上并不在旧金山附近比赛。如果没有交通，市中心到 Levi's 球场大约需要一小时。乘公共交通（也许还要借助 Uber/Lyft）则需要 90-120 分钟。\n* 我建议住在旧金山市内。如果你不想待在旧金山，那就住在靠近 BART 的地方，这样你可以观光而不会花太多钱。\n* 在旧金山，要注意 Tenderloin 是个非常糟糕的街区。那就是你总在 Fox News 上看到“旧金山失控”报道的地方。城市的其他地区都很安全，而且相当干净。\n* 旧金山西侧，尤其是 Sunset，与公共交通的连接较差。你当然可以不靠汽车出行，但前往市中心或火车系统会多花一点时间。\n恭喜退休！听起来是个不错的奖励。", "source": "Reddit", "engagement_timeframe": "10+ 条评论，1 周前" }, { "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": "4.53 万+观看，3 周前" }, { "pos": 3, "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco", "title": "旧金山 23 家最佳酒店，从 Mission Bay 到卡斯楚区" "source": "Condé Nast Traveller", "engagement_timeframe": "1 个月前" } ] } ... ```
键（results.what_people_are_saying）说明类型布局
items包含所有讨论论坛或社交媒体内容项的列表。数组桌面端和移动端
items.url讨论线程或社交媒体内容页面的 URL。整数桌面端和移动端
items.title讨论线程或内容片段的标题。字符串桌面端和移动端
items.top_comments如果显示，讨论线程中的热门评论。字符串桌面端和移动端
items.source托管内容的平台或网站名称。字符串桌面端和移动端
items.engagement_timeframe评论数量和活跃时间范围（例如“45 条评论，2 天前”）。字符串桌面端和移动端
### 搜索信息 该 `search_information` 该功能提供有关搜索查询的结构化信息。
```json ... "search_information": { "query": "restaurants", "geo_location": "10007, New York, NY", "showing_results_for": "restaurants", "total_results_count": 3200000000 }, ... ```
键（results.search_information）说明类型布局
query原始搜索词。字符串桌面端和移动端
geo_location *表示与搜索相关的具体地理区域。字符串桌面端
showing_results_for搜索结果所展示的搜索词。如果 Google 对提供的搜索词进行了自动更正，`query` 和 `showing_results_for` 可能不同。字符串桌面端和移动端
total_results_count搜索词找到的结果总数。整数桌面端和移动端
\*仅适用于 JS 渲染 ### 项目轮播 一个（`item_carousel`）与特定类型项目相关的图片或链接轮播显示在 SERP 最顶部。内容和布局会根据用户的搜索查询而变化，展示一组选定的相关项目。这可以涵盖从商品和新闻到图片的内容，为用户创造更具视觉吸引力且更具针对性的体验。
```json ... "item_carousel": { "items": [ { "pos": 1, "href": "/search?safe=off&sca_esv=589070032...", "title": "哈利法塔 828 米，顶端 830 米", "subtitle": "828米，顶端 830米" }, { "pos": 2, "href": "/search?safe=off&sca_esv=589070032...", "title": "Warisan Merdeka Tower 679 米", "subtitle": "679米" }, ... ], "title": "建筑物（按高度）", "pos_overall": 1 }, ... ```
键（results.item_carousel）说明类型布局
items轮播中的项目及其各自详情的列表。数组桌面端
items.pos项目在轮播中的位置。整数桌面端
items.href指向轮播中该项目的 Google SERP 的超链接。字符串桌面端
items.title轮播中实体的名称/标题。字符串桌面端
items.subtitle标题中实体的附加详情。字符串桌面端
title轮播部分的标题。标题与搜索查询相关。字符串桌面端
pos_overall表示项目轮播结果在 SERP 中的位置。整数桌面端
### 食谱 该 `recipes` Google 的 SERP 功能会在搜索结果顶部展示特定菜肴的烹饪说明、配料、评分和来源。
```json ... "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表示食谱结果在 SERP 中的位置。整数桌面端和移动端
### 视频 该 `videos` Google 搜索结果页中的该功能会显示与用户搜索查询相关的精选视频内容，包括缩略图、标题和来源信息。
```json ... "videos": { "items": [ { "pos": 1, "url": "https://www.youtube.com/watch?v=xFrGuyw1V8s", "title": "Abba - Dancing Queen（官方音乐视频修复版）", "author": "AbbaVEVO", "source": "YouTube" }, { "pos": 2, "url": "https://www.youtube.com/watch?v=-crgQGdpZR0", "title": "ABBA - Take A Chance On Me（官方音乐视频）", "author": "AbbaVEVO", "source": "YouTube" }, ... ], "pos_overall": 4 }, ... ```
键（results.videos）说明类型布局
items包含视频部分所有结果的列表。数组桌面端和移动端
items.pos视频在列表中的位置。整数桌面端和移动端
items.url视频链接。字符串桌面端和移动端
items.title视频的标题。字符串桌面端和移动端
items.author上传该视频的资料名称。字符串桌面端和移动端
items.source托管该视频的平台名称。字符串桌面端和移动端
pos_overall表示视频结果在 SERP 中的位置。整数桌面端和移动端
### 精选摘要 该 `featured_snippet` 这是一个独特的 Google 搜索结果，会在页面链接之前显示简洁摘要，概述该页面内容。这些高亮结果会显著显示在自然搜索结果顶部，为用户快速获取相关信息。
```json ... "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_shownSERP 中可见的精选摘要所在网站的 URL。字符串桌面端和移动端
pos_overall表示精选摘要结果在 SERP 中的位置。整数桌面端和移动端
键（results.related_searches_categorized）说明类型布局
items包含从 SERP 中水平轮播获取的所有相关搜索项的列表。数组桌面端
items.url相关搜索页面的 URL。字符串桌面端
items.title在浏览器中呈现的相关搜索结果名称。字符串桌面端
类别包含有关相关搜索结果类别的更多详情的对象。对象桌面端
category.name类别名称。字符串桌面端
category.type相关搜索部分的类型。字符串桌面端
pos_overall表示分类相关搜索结果在 SERP 中的位置。整数桌面端
### 酒店 Google `hotels` 这是一个直接在搜索结果中展示酒店信息的功能。当用户在 Google 上搜索酒店或住宿相关查询时，搜索引擎可能会在结果页顶部显示专门的酒店模块，方便而醒目地概览相关选项。
```json ... "hotels": { "date_to": "12 月 11 日，周一", "results": [ { "price": "£54", "title": "Hilton Garden Inn Vilnius City Centre", "description": "带餐厅/酒吧的现代酒店" }, { "price": "£57", "title": "Radisson Blu Hotel Lietuva", "description": "带水疗和餐饮的现代高层酒店" }, ... ], "date_from": "12 月 10 日，周日", "pos_overall": 5 }, ... ```
键（results.hotels）说明类型布局
date_to退房日期。字符串桌面端
results包含酒店所有详情的列表。数组桌面端
results.price酒店价格。字符串桌面端
results.title酒店名称。字符串桌面端
results.description酒店名称下方可见的简短说明。字符串桌面端
date_from入住日期。字符串桌面端
pos_overall表示酒店结果在 SERP 中的位置。整数桌面端
### 航班 该 `flights` 该功能会展示一个包含与相关搜索查询相对应的整理后航班选项的模块，方便用户直接在搜索结果中比较选项。
```json ... "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）说明类型布局
to到达机场。字符串桌面端和移动端
from出发机场。字符串桌面端和移动端
date_to到达日期。字符串桌面端和移动端
results精选航班及其各自详情的列表。数组桌面端和移动端
results.url指向 Google Flights 页面中列出某家航空公司所有航班的链接。字符串桌面端和移动端
results.type航班类型。字符串桌面端
results.price航班价格。字符串桌面端和移动端
results.airline承运航空公司名称。字符串桌面端和移动端
results.duration航班时长。字符串桌面端和移动端
date_from出发日期。字符串桌面端和移动端
pos_overall表示航班结果在 SERP 中的位置。整数桌面端和移动端
### 视频框 该 `video_boxes` 数组包含搜索结果页面顶部的特定视频结果，由 Google 选择为与查询最相关的内容。
```json ... "video_boxes": [ { "pos_overall": 1, "title": "Rick Astley - Never Gonna Give You Up（官方视频）（4K ...", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, { "pos_overall": 2, "title": "Rick Astley - Never Gonna Give You Up 1987（官方音乐 ...", "url": "https://www.youtube.com/watch?v=jzmz6K8K4L0" } ] ... ```
键（results.video_boxes）说明类型布局
pos_overall视频框的整体位置。整数桌面端和移动端
title视频的标题。字符串桌面端和移动端
url视频的 URL。字符串桌面端和移动端
### 本地服务广告 该 `local_service_ads` 该功能使水管工、电工、锁匠及其他本地服务提供商等面向服务的专业人士，能够在 Google 搜索结果页推广其服务。 
...
"local_service_ads": {
    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall & Katt, Attorneys at Law",
            "rating": 4.4,
            "reviews_count": 254,
        },
       ...
    ],
    "pos_overall": 2
},
...
键（results.local_service_ads）说明类型布局
items服务提供商及其各自详情的列表。数组桌面端
items.pos服务广告在本地服务广告 SERP 功能中的位置。整数桌面端
items.url本地服务搜索页面中该服务的链接。字符串桌面端
items.title服务提供商的标题。字符串桌面端
items.rating服务提供商的评分。整数桌面端
items.reviews_count服务提供商的评论数量。整数桌面端
pos_overall表示本地服务广告结果在 SERP 中的位置。整数桌面端
### 应用 该 `apps` SERP 功能会根据用户查询显示相关应用，提供价格、评分等关键信息。该功能为应用开发者和发布者提供了一个有价值的平台，可直接在 Google 搜索结果页提升其移动应用的可见性和互动。
```json ... "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包含 SERP 中该应用完整信息的应用商店 URL。字符串移动端
title应用标题。字符串移动端
rating应用评分。整数移动端
reviews_count应用商店中该 Apps SERP 结果可用的评论总数。整数移动端
items.reviews_count服务提供商的评论数量。字符串移动端
### **金融** 公司的财务数据摘要，包括股价、市值和其他关键指标。 #### **HTML 示例**
| 键（results.finance） | 说明 | 类型 | 布局 | | --------------------- | ---------------------------- | --- | --- | | `最低` | 指定日期的最低价格。 | 浮点数 | 桌面端 | | `日期` | 报告净资产价值时的日期。 | 字符串 | 桌面端 | | `最高` | 指定日期的最高价格 | 浮点数 | 桌面端 | | `开盘` | 指定日期的开盘价 | 浮点数 | 桌面端 | | `source` | 相关 Google Finance 来源网站的 URL。 | 字符串 | 桌面端 | | `差额` | 最近报告的净资产价值与其前一条之间的变化。 | 字符串 | 桌面端 | | `market_cap` | 公司已发行股票的总美元价值 | 字符串 | 桌面端 | | `stock_name` | 股票名称。 | 字符串 | 桌面端 | | `52_week_low` | 52 周最低价 | 浮点数 | 桌面端 | | `52_week_high` | 52 周最高价 | 浮点数 | 桌面端 | | `current_price` | 实时价格报价。 | 字符串 | 桌面端 | | `dividend_yield` | 股票的股息率是每股股息除以每股价格 | 浮点数 | 桌面端 | | `price_earning_ratio` | 股票的市盈率 | 浮点数 | 桌面端 | #### JSON 示例 ```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 美元", "dividend_yield": 0, "price_earnings_ratio": 41.47 }, ... ``` ### 体育赛事 近期体育比赛信息，详细说明比分、球队、比赛类型和亮点。 #### **HTML 示例**
键（results.sports_games）说明类型布局
games一个提供多场体育赛事信息的数组数组桌面端
games.date比赛计划进行或实际发生的日期和时间字符串桌面端
games.teams比赛中的参赛队伍数组桌面端
games.game_type所进行的比赛类型，例如常规赛、季后赛、冠军赛等字符串桌面端
games.highlight比赛精彩片段的链接，例如关键进球等字符串桌面端
games.teams.score比赛中每支队伍获得的得分或分数字符串桌面端
games.teams.winner指定哪支队伍赢得了比赛布尔值桌面端
games.teams.team_name显示比赛中参赛队伍的名称字符串桌面端
阶段体育比赛或锦标赛的具体阶段或轮次。字符串桌面端
联赛指负责该比赛的体育联赛或组织字符串桌面端
#### **JSON 示例** ```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": "EuroLeague" }, ... ``` ### 讨论和论坛 带有 URL、标题、来源和评论数的讨论线程和论坛帖子列表。 #### **HTML 示例**
键（results.discussions_and_forums）说明类型布局
itemsGoogle 已索引的论坛或讨论线程中的一组项目或条目数组桌面端
items.pos表示某个项目在所有“讨论和论坛”结果中的位置的指标。整数桌面端
items.url指向特定论坛帖子或讨论线程的 URL 链接字符串桌面端
items.title论坛帖或讨论主题的标题或主标题字符串桌面端
items.source承载该论坛或讨论的来源字符串桌面端
items.timeframe论坛帖子或讨论的时间范围或日期字符串桌面端
items.comments_count论坛帖子或讨论线程收到的评论或回复数量字符串桌面端
pos_overall表示 Discussions and Forums SERP 功能在 SERP 中位置的指示。整数桌面端
#### **JSON 示例** ```json ... "discussions_and_forums": { "items": [ { "pos": 1, "url": "https://www.reddit.com/r/webscraping/comments/y4v5ws/free_http_proxy/", "title": "Free HTTP Proxy? : r/webscraping - Reddit", "source": "Reddit", "timeframe": "1年", "comments_count": "20+ 条评论" }, ... ], "pos_overall": 7 } }, ... ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/targets/google/search/search.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.