> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/sou-suo-yin-qing/gu-ge/sou-suo/wang-ye-sou-suo.md).

# 网页搜索

功能全面的 Google Search 抓取器，提供自然结果、广告、摘要、热门故事等的解析数据。

该 `google_search` 来源旨在获取 Google 搜索结果页（SERP）和 [Google AI Overviews](https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/sou-suo-yin-qing/gu-ge/ai-overviews.md) 结果。此子页面专门介绍 Google 网页搜索相关信息。要了解其他结果类型，请阅读 [**图片搜索**](https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/sou-suo-yin-qing/gu-ge/sou-suo/tu-pian-sou-suo.md) 或 [**新闻搜索**](https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/sou-suo-yin-qing/gu-ge/sou-suo/xin-wen-sou-suo.md).

## 请求示例

在以下示例中，我们发起请求以获取 `2` 结果页，起始页码为 `11` ，页码为 `12` ，搜索词为 `adidas`。API 将返回解析后的结果。

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://data.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
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint


# 结构化载荷。
payload = {
    'source': 'google_search',
    'query': 'adidas',
    'start_page': 11,
    'pages': 2,
    'parse': True,
}


# 获取响应。
response = requests.request(
    'POST',
    'https://data.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# 将格式化后的响应打印到标准输出。
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,
};

const options = {
    hostname: "data.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="PHP" %}

```php
<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'start_page' => 11,
    'pages' => 2,
    'parse' => true,
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://data.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,
    }

    jsonValue, _ := json.Marshal(payload)

    client := &http.Client{}
    request, _ := http.NewRequest("POST",
        "https://data.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,
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://data.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);

        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)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://data.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
}
```

{% endtab %}
{% endtabs %}

我们的示例使用 [**Push-Pull**](https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods/push-pull.md) 集成方式。提交作业后会立即返回作业 ID，而不是结果。作业状态变为 `done`后，使用 `GET https://data.oxylabs.io/v1/queries/{job_id}/results`获取结果。请参阅 [**Push-Pull**](https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods/push-pull.md) ，了解如何检查作业状态、使用回调和提交批量查询。

## 请求参数值

### 通用

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

<table><thead><tr><th width="150">参数</th><th width="500.3333333333333">描述</th><th width="114.66666666666674">默认值</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>设置爬虫。使用 <code>google_search</code>.</td><td>–</td></tr><tr><td><mark style="background-color:green;"><strong><code>query</code></strong></mark></td><td>要搜索的关键词或短语。</td><td>–</td></tr><tr><td><code>render</code></td><td>设置为 <code>html</code>. <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/features/js-rendering-and-browser-control.md#javascript-rendering"><strong>更多信息</strong></a><strong>.</strong></td><td>–</td></tr><tr><td><code>parse</code></td><td>设置为 <code>true</code>时返回解析后的数据。查看输出 <a href="#output-data-dictionary"><strong>数据字典</strong></a>.</td><td><code>false</code></td></tr><tr><td><code>callback_url</code></td><td>回调端点的 URL。 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods/push-pull.md"><strong>更多信息</strong></a></td><td>–</td></tr><tr><td><code>user_agent_type</code></td><td>设备类型和浏览器。完整列表请见 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/features/http-context-and-job-management/user-agent-type.md"><strong>此处</strong></a>.</td><td><code>desktop</code></td></tr></tbody></table>

\- 必填参数

#### 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"
}
```

### 本地化

根据特定地理位置、区域设置和语言调整搜索结果。

<table><thead><tr><th width="129">参数</th><th width="521.3333333333333">描述</th><th width="116.66666666666669">默认值</th></tr></thead><tbody><tr><td><code>geo_location</code></td><td>结果所适用的地理位置。正确使用此参数对于获取正确的数据至关重要。有关详情，请阅读我们建议的 <code>geo_location</code> 参数结构 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/features/localization/serp-localization.md#google"><strong>此处</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>locale</code></td><td><code>Accept-Language</code> 标头值，用于更改 Google 搜索页面界面的语言。 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/features/localization/domain-locale.md#google"><strong>更多信息</strong></a>.</td><td>-</td></tr></tbody></table>

### 分页

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

<table><thead><tr><th width="207">参数</th><th width="446.3333333333333">描述</th><th width="112">默认值</th></tr></thead><tbody><tr><td><code>start_page</code></td><td>起始页码。</td><td><code>1</code></td></tr><tr><td><code>pages</code></td><td>要检索的页数。</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>每页要检索的结果数量。</td><td><code>10</code></td></tr><tr><td><code>context</code>:<code>limit_per_page</code></td><td>使用相同的 IP 地址和会话（已设置 Cookie）抓取多个页面。将页码指定为 JSON 数组，并使用 <code>page</code> 键指定页码，再使用 <code>limit</code> 键指定每页的自然搜索结果数，这样可以尽量避免不同页面出现重复的自然搜索结果（例如，第一页的最后一条自然搜索结果与第二页的第一条相同）。 <a href="#request-sample"><strong>查看示例</strong></a><strong>.</strong></td><td>-</td></tr></tbody></table>

#### 支持连续滚动

网页爬虫API 完全支持 Google 搜索连续滚动。它会自动检测连续滚动布局，高效加载所需的自然搜索结果，无需设置任何额外参数。

#### 每页结果数限制

{% hint style="warning" %}
由于 Google 最近调整了限制，我们也相应调整了网页爬虫API 的行为。每页结果数上限将与 Google 的自然搜索结果数量一致，通常为 10 条。
{% endhint %}

要使用此功能，请提供一个 JSON 数组，其中包含以下数据的 JSON 对象：

<table><thead><tr><th width="98">参数</th><th width="581.3333333333333">描述</th><th width="84.66666666666674">示例</th></tr></thead><tbody><tr><td><code>page</code></td><td>要抓取的页码。任何大于 <code>0</code> 的整数值均可</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>相关页面上的结果数量。介于 <code>1</code> 和 <code>100</code> 之间（含两端）的任何整数值均可。</td><td><code>90</code></td></tr></tbody></table>

#### 请求示例

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

### 筛选

根据各种条件筛选和优化搜索结果。了解如何使用 context 参数 [**此处**](#context-parameters).

<table><thead><tr><th width="123">参数</th><th width="533.3333333333333">描述</th><th width="112.66666666666669">默认值</th></tr></thead><tbody><tr><td><code>context</code>:<br><code>filter</code></td><td>将此参数的值设为 <code>0</code> 即可查看因与其他结果相似而被排除的结果。</td><td><code>1</code></td></tr><tr><td><code>context</code>:<br><code>safe_search</code></td><td>安全搜索。设置为 <code>true</code> 即可启用。</td><td><code>false</code></td></tr><tr><td><code>context</code>:<br><code>udm</code></td><td><code>udm</code> 参数可用于切换不同的搜索标签页，例如图片、地点或视频，从而自定义显示的结果类型。查看可接受的值 <a href="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FeoShpvYuZlb4hGpCIXNG%2Fudm_values%20(eu%2Bus).json?alt=media&#x26;token=a6b77fab-b170-478c-b06f-b8fbf7ab64c7"><strong>此处</strong></a>.</td><td>-</td></tr><tr><td><code>context</code>:<br><code>tbm</code></td><td>待匹配项或 <code>tbm</code> 参数。可用值： <code>bks</code> （图书）， <code>isch</code> （图片）， <code>nws</code> （新闻）， <code>vid</code> （视频）， <code>lcl</code> （本地）结果。</td><td>-</td></tr><tr><td><code>context</code>:<br><code>tbs</code></td><td>此参数类似一个容器，用于传递一些不太常见的 Google 参数，例如按日期筛选或排序结果，以及其他筛选条件；其中一些筛选条件取决于 <code>tbm</code> 参数。更多信息请参阅 <a href="https://stenevang.wordpress.com/2013/02/22/google-advanced-power-search-url-request-parameters/"><strong>此处</strong></a>.</td><td>-</td></tr></tbody></table>

{% hint style="warning" %}
`udm` 和 `tbm` context 参数不能在同一个抓取请求中同时使用；请仅选择一个。同时使用两者可能会导致冲突或出现意外行为。
{% endhint %}

### 其他

用于满足特定需求的其他高级设置和控件。

<table><thead><tr><th width="97">参数</th><th width="558.3333333333333">描述</th><th width="112.66666666666669">默认值</th></tr></thead><tbody><tr><td><code>context</code>:<br><code>fpstate</code></td><td>将 <code>fpstate</code> 值设为 <code>aig</code> 将使 Google 加载更多应用。此参数仅在与 <code>render</code> 参数一起使用时才有用。</td><td>-</td></tr><tr><td><code>context</code>:<br><code>nfpr</code></td><td><code>true</code> 将关闭拼写自动更正</td><td><code>false</code></td></tr></tbody></table>

### Context 参数

所有 context 参数都应作为对象添加到 `context` 数组中，并包含 `key` 和 `value` 键值对，例如：

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

## 结构化数据

网页爬虫API能够提取包含 Google 搜索结果的 HTML 或 JSON 对象，并为结果页面中的各种元素提供结构化数据。

<details>

<summary><code>google_search</code> 结构化输出</summary>

```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 美国官方网站",
                            "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": "你的 adidas——不只是购物应用 adidas 应用是运动和运动鞋爱好者的天地，让你更贴近精彩赛事，并能抢先购买新款运动鞋，...大小：115M 更新日期：2022年5月3日 评分：4.8 · 322,391 条评价 · 免费 · Android · 体育",
                            "title": "adidas - 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 天前"
                            },
                            {
                                "pos": 3,
                                "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "你会如何向外星人描述你最喜欢的运动？",
                                "timeframe": "2022 年 4 月 27 日"
                            }
                        ],
                        "title": "",
                        "pos_overall": 7
                    },
                    "top_stories": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/adilette-comfort-slides/GZ5898.html",
                                "title": "adidas Adilette Comfort Slides - 米色 | 女士泳装 | adidas 美国",
                                "source": "",
                                "timeframe": "8 小时前"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "女士服装促销，最高立减 50% | adidas 美国",
                                "source": "",
                                "timeframe": "2021 年 9 月 30 日"
                            }
                        ],
                        "pos_overall": 3
                    },
                    "instant_answers": [
                        {
                            "type": "unknown",
                            "_parsed": false,
                            "pos_overall": 5
                        }
                    ],
                    "popular_products": {
                        "items": [
                            {
                                "pos": 1,
                                "title": "Adidas Yeezy 儿童 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,
                },
                "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"
        }
    ]
}
```

</details>

{% hint style="info" %}
元素的组成可能会因其是 **桌面端** 或 **移动设备** 搜索。
{% endhint %}

如需识别特定元素，请参阅各类 Google 搜索结果的数据字典，无论这些结果来自桌面端还是移动端搜索。

## 输出数据字典

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

#### **JSON 结构**

Google 网页搜索的结构化输出包含以下字段： `URL`, `page`, `results`等。下表详细列出了我们解析的每种搜索结果页（SERP）功能，并说明其数据类型。表中还包含一些元数据。

{% hint style="info" %}
具体结果类型包含的项目数和字段数可能因搜索查询而异。
{% endhint %}

<table data-full-width="false"><thead><tr><th width="289">键名</th><th width="337.3333333333333">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>url</code></td><td>Google 搜索页面的网址。</td><td>字符串</td></tr><tr><td><code>page</code></td><td>相对于 Google 搜索结果页（SERP）分页的页码。</td><td>整数</td></tr><tr><td><code>results</code></td><td>包含搜索结果的字典。</td><td>对象</td></tr><tr><td><code>results.pla</code></td><td>包含商品详情的商品列表广告列表。</td><td>对象</td></tr><tr><td><code>results.paid</code></td><td>包含各自详情的赞助结果列表。</td><td>数组</td></tr><tr><td><code>results.images</code></td><td>包含各自详情的图片结果列表。</td><td>对象</td></tr><tr><td><code>results.flights</code></td><td>包含各自详情的航班列表。</td><td>对象</td></tr><tr><td><code>results.organic</code></td><td>包含各自详情的非付费结果列表。</td><td>数组</td></tr><tr><td><code>results.organic_videos</code></td><td>包含各自详情的自然视频列表。</td><td>数组</td></tr><tr><td><code>results.top_sights</code></td><td>包含著名地标或景点及其详情的列表。</td><td>数组</td></tr><tr><td><code>results.jobs</code></td><td>包含职位信息及其详情的列表。</td><td>对象</td></tr><tr><td><code>results.local_service_ads</code></td><td>本地服务提供商的赞助结果列表。</td><td>对象</td></tr><tr><td><code>results.video_boxes</code></td><td>搜索结果页（SERP）中的视频框及其详情。</td><td>数组</td></tr><tr><td><code>results.recipes</code></td><td>包含各自详情的食谱列表。</td><td>对象</td></tr><tr><td><code>results.twitter</code></td><td>包含各自详情的 Twitter（X）结果列表。</td><td>数组</td></tr><tr><td><code>results.local_pack</code></td><td>包含与搜索相关的本地商家列表。</td><td>对象</td></tr><tr><td><code>results.item_carousel</code></td><td>用于信息查询的示例条目列表及其各自的详细信息。</td><td>对象</td></tr><tr><td><code>results.videos</code></td><td>视频列表及其各自的详细信息。</td><td>对象</td></tr><tr><td><code>results.hotels</code></td><td>与搜索查询中使用的位置相关的酒店列表。</td><td>对象</td></tr><tr><td><code>results.apps</code></td><td>应用程序列表及其各自的详细信息。</td><td>数组</td></tr><tr><td><code>results.finance</code></td><td>公司财务数据摘要，包括股价、市值和其他关键指标。</td><td>对象</td></tr><tr><td><code>results.sports_games</code></td><td>近期体育赛事的信息，包括比分、参赛队伍、比赛类型和精彩集锦。</td><td>对象</td></tr><tr><td><code>results.discussions_and_forums</code></td><td>讨论串和论坛帖子的列表，包含网址、标题、来源和评论数。</td><td>对象</td></tr><tr><td><code>results.featured_snippet</code></td><td>从 SERP 自然搜索结果中检索到的特定结果列表。</td><td>数组</td></tr><tr><td><code>results.top_stories</code></td><td>当搜索查询被识别为新闻类查询时，返回文章列表及其各自的详细信息。</td><td>对象</td></tr><tr><td><code>results.popular_products</code></td><td>Google Shopping 商品列表的非付费自然展示结果及其各自的详细信息。</td><td>对象</td></tr><tr><td><code>results.related_searches</code></td><td>搜索页面不同位置显示的一个或多个相关搜索区块的列表。</td><td>数组</td></tr><tr><td><code>results.related_questions</code></td><td>相关疑问式搜索查询列表及其各自的详细信息。</td><td>对象</td></tr><tr><td><code>results.what_people_are_saying</code></td><td>讨论串和论坛帖子的列表，包含网址、标题、来源、热门评论、互动程度和时间范围。</td><td>数组</td></tr><tr><td><code>results.search_information</code></td><td>已提交搜索查询的详细信息列表。</td><td>对象</td></tr><tr><td><code>total_results_count</code></td><td>搜索查询找到的结果总数。</td><td>字符串</td></tr><tr><td><code>last_visible_page</code></td><td>用于标识搜索结果页面中可见最大页码的值。（如果通过滚动触发加载更多结果，则为 -1。）</td><td>整数</td></tr><tr><td><code>parse_status_code</code></td><td>解析任务的状态码。解析器状态码的说明请参见 <a href="https://developers.oxylabs.io/scraper-apis/web-scraper-api/response-codes#parsers"><strong>此处</strong></a>.</td><td>整数</td></tr><tr><td><code>created_at</code></td><td>抓取任务创建时的时间戳。</td><td>时间戳</td></tr><tr><td><code>updated_at</code></td><td>抓取任务完成时的时间戳。</td><td>时间戳</td></tr><tr><td><code>job_id</code></td><td>与该抓取任务关联的任务 ID。</td><td>字符串</td></tr><tr><td><code>status_code</code></td><td>抓取任务的状态码。抓取器状态码的说明请参见 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/response-codes.md"><strong>此处</strong></a>.</td><td>整数</td></tr><tr><td><code>parser_type</code></td><td>用于解析 HTML 内容的解析器类型。</td><td>字符串</td></tr></tbody></table>

{% hint style="info" %}
在以下各节中，如果某种结果类型包含多个条目，则会缩短相应的已解析 JSON 代码片段。
{% endhint %}

### 商品列表广告（PLA）

该 `pla` 搜索结果中的此部分指商品详情广告（Product Listing Ads），也称为 Google Shopping Ads，以轮播形式醒目地显示在搜索页面顶部。

```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 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
},
...
```

<table><thead><tr><th width="155">键（results.pla）</th><th width="370">描述</th><th width="83">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>页面中所有可用的 PLA。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>指示某个商品在 PLA 结果中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>商品列表广告中商品的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>商品的 URL</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.price</code></td><td>商品列表广告中商品的价格。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.seller</code></td><td>商品列表广告中商品的卖家。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.url_image</code></td><td>商品图片的 URL。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.image_data</code></td><td>商品缩略图的 Base64 编码。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>指示 PLA 搜索引擎结果页（SERP）功能在 SERP 中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 付费广告

此 `paid` 部分指由 Google Ads 提供支持的广告，通常显示在自然（非付费）搜索结果上方。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-584ef339902e29b5e8867fbd11f3d95647948dd9%2Fgoogle_search_9.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
... 
"paid": [
    {
        "pos": 1,
        "url": "https://www.adidas.com/us/cyber_monday",
        "desc": "Last Chance For Cyber Deals. Extra 45% Off Sale & Full Price Products With Code CYBERSALE. Shop The adidas\u00ae Official Site Today. Join Our adiClub Loyalty Program. Members Only Rewards. adiClub Exclusives.",
        "title": "adidas Official Website | Extra 45% Off | Code CYBERSALE",
        "data_rw": "https://www.google.com/aclk?...",
        "sitelinks": {
            "expanded": [
                {
                    "url": "https://www.adidas.com/us/shop",
                    "desc": "Last Chance For Cyber Deals. Extra 45% Off With Code CYBERSALE.",
                    "title": "Cyber Monday Sale"
                },
                {
                    "url": "https://www.adidas.com/us/shoes",
                    "desc": "Find The Right Shoes Today. Sport & Lifestyle Shoes Available Online.",
                    "title": "adidas\u00ae Shoes"
                },
                {
                    "url": "https://www.adidas.com/us/ultraboost",
                    "desc": "Incredible Energy Return Shop The New Ultraboost\u2122 Light Today.",
                    "title": "adidas\u00ae Ultraboost\u2122 Light"
                },
                {
                    "url": "https://www.adidas.com/us/nmd",
                    "desc": "Shop The Latest NMD Shoe Releases By adidas Originals Online Today.",
                    "title": "adidas\u00ae NMD"
                }
            ]
        },
        "url_shown": "https://www.adidas.com \u203a official \u203a site",
        "pos_overall": 1
    }
],
... 
```

<table><thead><tr><th width="216">键（results.paid）</th><th width="281">描述</th><th width="118">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos</code></td><td>用于指示某个条目在付费结果中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>url</code></td><td>付费结果的网址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>desc</code></td><td>付费结果的简短描述。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>title</code></td><td>付费结果的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>data_rw</code></td><td>付费结果的重定向 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks</code></td><td>包含网站内部链接信息的对象，这些链接会显示在 Google 上的首个搜索结果下方。</td><td>对象</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.inline/expanded</code></td><td>URL 列表及其各自的详细信息。键的名称（`inline`/`expanded`）指定了该 <code>sitelinks</code> 元素类型。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.inline.url</code></td><td>链接网站的 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.inline.title</code></td><td>链接网站的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.inline.description</code></td><td>链接网站的简短描述。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>url_shown</code></td><td>显示在描述正下方的简略 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>付费搜索结果在搜索引擎结果页（SERP）中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 图片

该 `images` 此部分指 SERP 页面不同区域中显示的图片结果，这些结果可能位于专门的版块中，也可能显示在页面顶部。请注意，从 Google 搜索结果中抓取的数据结构可能与从 Google 图片搜索结果中抓取的数据结构不同。

```json
...
"images": {
    "items": [
        {
            "alt": "阿迪达斯 | 历史、产品与事实 | 大英百科全书",
            "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
},
...
```

<table><thead><tr><th width="205">键（results.images）</th><th width="295">描述</th><th width="112">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>包含图片及其各自详细信息的列表。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.alt</code></td><td>图像的替代文本。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>用于标识图像在列表中位置的唯一标记。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>包含该图像的网页 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>图片 SERP 功能在 SERP 中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 自然搜索

该 `organic` 部分指 Google 自然搜索结果中的非付费列表，这些列表由 Google 的算法根据相关性确定。它们显示在搜索页面上的付费广告下方。

#### 示例 1

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-e55d9685c1492a0c538d06d3bf3d5714182d1e31%2Fgoogle_search_10.png?alt=media" alt=""><figcaption></figcaption></figure>

```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": "Perfect 燕麦曲奇"
                }
            ]
        },
        "url_shown": "https://www.loveandlemons.com\u203a 食谱",
        "pos_overall": 2
    },
...
```

#### 示例 2

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-b7fd59122ccfb690659bfa7621bd7daa1c41ac3e%2FScreenshot%202024-12-02%20at%2016.28.05.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
...
"organic": [
    {
        "位置": 9,
        "pos_overall": 13,
        "title": "经典款冬季运动夹克 - 军绿色",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "一款源自户外冬季运动的柔软羊羔绒运动夹克 \u00b7 宽松版型休闲自在，毫无束缚感 \u00b7 外层：70% 聚酯纤维 / 30% 再生\u00a0...", 
        "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 天内免费退货"
        ]
    },
...
```

<table><thead><tr><th width="229">键（results.organic）</th><th width="309">描述</th><th width="85">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos</code></td><td>表示某个项目在自然搜索结果中所处位置的指标。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>url</code></td><td>自然搜索结果的网址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>desc</code></td><td>自然搜索结果的简短描述。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>title</code></td><td>自然搜索结果的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>images</code></td><td>自然搜索结果的缩略图图片（以 base64 编码）。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks</code></td><td>对象包含 `expanded` 或 `inline` 元素，其中包含有关站点链接的更多详细信息。</td><td>对象</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.expanded/inline</code></td><td>自然搜索结果的站点链接列表。键的名称（<code>inline</code>/<code>expanded</code>) 指定站点链接元素的类型。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.expanded.url</code></td><td>链接网站的 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>sitelinks.expanded.title</code></td><td>链接网站的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>url_shown</code></td><td>显示在描述正下方的简略 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>自然搜索结果在 SERP 中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>favicon_text</code></td><td>与网站图标（favicon）关联的文本或名称。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>rating</code></td><td>产品或内容的平均评分。</td><td>浮点数</td><td>桌面端</td></tr><tr><td><code>review_count</code></td><td>与该产品或内容相关的评论数量。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>additional_info</code></td><td>包含有关价格、库存情况、产品评分、配送选项和退货政策的详细信息。</td><td>字符串列表</td><td>桌面端</td></tr></tbody></table>

### 自然视频

该 `results.organic_videos` 包含一个视频列表数组，这些视频自然显示在搜索结果中，也就是说，它们不是付费广告。每个视频条目都包含相关详情，例如视频标题、URL 和说明。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-144c011330865d1150aeb799bd457767833c511a%2Fgoogle_search_1.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
...
 "organic_videos": [
    {
        "pos": 1,
        "url": "https://www.youtube.com/watch?v=XHTrLYShBRQ",
        "desc": "Your browser can't play this video. Learn more.",
        "title": "Introducing iPhone 15 | WOW | Apple - YouTube",
        "pos_overall": 6
    },
...
```

<table><thead><tr><th width="259">键 (results.organic_videos)</th><th width="294">描述</th><th width="100">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos</code></td><td>用于标示某个条目在自然视频结果中的位置。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>url</code></td><td>视频的 URL。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>desc</code></td><td>视频的简短说明。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>title</code></td><td>视频的标题。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>自然视频结果在搜索引擎结果页 (SERP) 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 热门景点

该 `results.top_sights` 包含一个知名地标或景点列表，这些地点通常与搜索位置或主题相关。每个条目都包含位置和标题等详细信息。

```json
...
"top_sights": {
    "items": [
        {
            "pos": 1,
            "title": "Vilnius Cathedral"
        },
        {
            "pos": 2,
            "title": "Gediminas Castle Tower"
        },
        {
            "pos": 3,
            "title": "Gates of Dawn"
        }
    ],
    "pos_overall": 1
},
...
```

<table><thead><tr><th width="227">键 (results.top_sights)</th><th width="339">描述</th><th width="90">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>热门景点列表及其各自的详细信息。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>items.pos</code></td><td>热门景点结果在“热门景点”SERP 功能中的位置。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>items.title</code></td><td>旅游景点的名称。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>热门景点结果在 SERP 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 职位

该 `results.jobs` 包含从搜索结果中提取的招聘信息。每条信息都包含指向职位发布页面的 URL、职位名称、来源、雇主和地点等详细信息。这些信息来自 Google 收录的各类招聘网站、职业网站及其他平台。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-ed269f508b7870d64217019ecb61c2b555b438a9%2Fgoogle_search_3.png?alt=media" alt=""><figcaption></figcaption></figure>

```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": "Attorney",
            "source": "via LinkedIn",
            "employer": "Men's & Fathers' Rights Divorce Lawyers, Schultz & Associates, LLC",
            "location": "United States"
        },
                            ...
    ],
    "pos_overall": 1
},
...
```

<table><thead><tr><th width="222">键 (results.jobs)</th><th width="318">描述</th><th width="94">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>listings</code></td><td>页面中所有可用招聘信息的数组。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>listings.url</code></td><td>完整招聘信息的 URL。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>listings.title</code></td><td>职位名称。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>listings.source</code></td><td>包含原始职位发布信息的来源。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>listings.employer</code></td><td>招聘该职位的组织。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>listings.location</code></td><td>该职位的地点。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>指示 Jobs SERP 功能在 SERP 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### Twitter (X)

此 `twitter` 功能通常会针对品牌、电影、音乐家和其他名人显示，一般位于该品牌网站的搜索结果正下方。此功能提供指向品牌 Twitter 信息流的直接链接，并以轮播形式展示其最新推文。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-0a557698126203878e2b3eec6c37dcd4a7e7cda5%2Fgoogle_search_13.png?alt=media" alt=""><figcaption></figcaption></figure>

```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": "You can now redeem your #MyNintendo Platinum Points to collect holiday themed custom icons, available until 12/25 at 5pm PT. #NintendoSwitchOnline #MissionsAndRewards\n\nLearn more: ninten.do/6017iHF1b",
            "timeframe": "12 hours ago"
        },
        ...
    ],
    "title": "Nintendo of America (@NintendoAmerica) \u00b7 X",
    "pos_overall": 4
},
...
```

<table><thead><tr><th width="201">键（results.twitter）</th><th width="329">描述</th><th width="108">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos</code></td><td>表示某个项目在自然搜索结果中所处位置的指标。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>url</code></td><td>包含 Twitter (X) 帖子的个人资料网址。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items</code></td><td>Twitter (X) 帖子列表及其各自的详细信息。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>items.pos</code></td><td>指示某条推文在 Twitter (X) SERP 功能中的位置。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.url</code></td><td>Twitter (X) 帖子的网址。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.content</code></td><td>简短描述相关 Twitter (X) 帖子中的全部文本。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.timeframe</code></td><td>描述该推文发布于多久之前。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>title</code></td><td>Twitter (X) 个人资料的标题。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>指示 Twitter 搜索结果在 SERP 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 本地商家包

此 `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
                    },
...
```

<table><thead><tr><th width="230">键（results.local_pack）</th><th width="277">描述</th><th>类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>地点列表及其各自的详细信息。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.cid</code></td><td>分配给特定商家列表的唯一识别编号。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>本地结果在本地商家包中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>本地实体的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.rating</code></td><td>本地实体的评分。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.address</code></td><td>本地实体的地址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.rating_count</code></td><td>本地实体的评分数量。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>Local Pack 结果在 SERP 中的位置指示。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 头条新闻

`top_stories` 是 Google 搜索中针对新闻类查询显示的专属版块。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-201882e928731ed8359a39ff9ffca5eba879053a%2Fgoogle_search_12.png?alt=media" alt=""><figcaption></figcaption></figure>

```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 users mock 'triggered' Elon Musk over Leave the World Behind \ncomplaint11 hours ago",
            "source": "The Independent",
            "timeframe": "11 hours ago"
        },
        ...
    ],
    "pos_overall": 3
},
...
```

<table><thead><tr><th width="233">键 (results.top_stories)</th><th width="295">描述</th><th width="100">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>精选新闻文章列表及其各自的详细信息。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>文章在 Top Stories SERP 功能中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>完整文章的网址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>文章标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.section</code></td><td>Top Stories 版块的名称。</td><td>字符串</td><td>移动设备</td></tr><tr><td><code>items.source</code></td><td>发布该文章的网站名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.timeframe</code></td><td>说明文章发布于多久之前。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>表示 Top Stories SERP 功能在 SERP 中的整体位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 热门商品

此 `popular_products` SERP 功能会展示一个轮播栏，其中包含根据用户查询的热度和相关性确定的各类商品。这与受广告商影响的商品列表广告 (PLA) 不同。请注意，单个 `popular_products` SERP 页面上可能会出现多个轮播栏。

```json
"popular_products": [
    {
        "items": [
            {
                "pos": 1,
                "url": "https://www.google.com/search?ibp=oshop&q=adidas+soccer+socks...",
                "title": "adidas Team Speed 4 Soccer OTC",
                "token": "eyJjYXRhbG9naWQiOiAiMTIwMjUyMDU5NzYwMDQwMzMyNjAi...",
                "rating": "3.7",
                "sellers": [
                    {
                        "pos": 1,
                        "price_str": "$18.00",
                        "seller_name": "DICK'S Sporting Goods"
                    }
                ],
                "currency": "USD",
                "image_data": "UklGRsANAABXRUJQVlA4ILQNAADwPgCdASpwACwBPj0Uj0ei...",
                "description": "DICK'S Sporting Goods & more",
                "rating_count": 92
            },
            {
                "pos": 2,
                "url": "https://www.google.com/search?ibp=oshop&q=adidas+soccer+socks...",
                "title": "adidas 3-Stripe Hoop Soccer Socks",
                "token": "eyJjYXRhbG9naWQiOiAiMTYyMDk5ODYzOTM1NTY2NjM5NjAi...",
                "rating": "4.7",
                "sellers": [
                    {
                        "pos": 1,
                        "price_str": "$15.00",
                        "seller_name": "DICK'S Sporting Goods"
                    }
                ],
                "currency": "USD",
                "image_data": "UklGRrASAABXRUJQVlA4IKQSAADwSQCdASp1ACwBPkESkEgi...",
                "description": "DICK'S Sporting Goods & more",
                "rating_count": 110
            },
            ...
        ],
        "pos_overall": 4
    },
    ...
]
```

<table><thead><tr><th width="221.5">键 (results.popular_products)</th><th width="360.5">描述</th><th width="70.5">类型</th><th width="121.5">布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>热门商品列表及其各自的详细信息。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>用于指示某个热门商品在热门商品 SERP 功能中位置的唯一标识。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>该商品在 Google Shopping 页面上的网址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>商品标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.token</code></td><td>商品令牌（与 <code>google_shopping_product</code> <a href="broken://pages/5bfbdac1ecc82a8949cf05b3dd41fbe20a049d3b">来源</a> （用于卖家、定价和产品详情）。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.rating</code></td><td>指定热门产品的评分。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.sellers</code></td><td>提供该产品的卖家列表及各自的详细信息。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.sellers.pos</code></td><td>卖家在卖家列表中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.sellers.price_str</code></td><td>该卖家提供的产品价格。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.sellers.seller_name</code></td><td>产品卖家的名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.currency</code></td><td>所列价格的货币代码。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.image_data</code></td><td>商品缩略图的 Base64 编码。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.description</code></td><td>产品卖家的简短介绍。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.rating_count</code></td><td>该产品的评分数量。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>表示热门产品 SERP 功能在 SERP 中的总体位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 相关搜索

此 `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"
       ]
   }
],
```

<table><thead><tr><th width="274">键 (results.related_searches)</th><th width="252">描述</th><th width="93">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos_overall</code></td><td>表示此相关搜索区块在搜索页面中的总体位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>related_searches</code></td><td>此区块中的相关搜索字符串列表。</td><td>数组</td><td>桌面端和移动端</td></tr></tbody></table>

### 相关问题

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

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-2113f0dc364f37dac6f833ac681bd5b261c95bd1%2Fgoogle_search_5.png?alt=media" alt=""><figcaption></figcaption></figure>

```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
},
...
```

<table><thead><tr><th width="279">键 (results.related_questions)</th><th width="256">描述</th><th width="91">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>包含所有相关问题的列表。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>用于标识任意相关问题在“相关问题”SERP 功能中的位置的唯一标识符。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.answer</code></td><td>相关问题的答案。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.source</code></td><td>包含用于描述答案来源的值。</td><td>对象</td><td>桌面端和移动端</td></tr><tr><td><code>items.source.url</code></td><td>用于获取答案的网站 URL。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.source.title</code></td><td>包含答案的网站标题。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.source.url_shown</code></td><td>答案正下方显示的简短 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.question</code></td><td>相关问题部分中的问题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>表示相关问题 SERP 功能在 SERP 中的整体位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 大家在说什么

“ `what_people_are_saying` ”部分会在 Google 搜索结果中显示，前提是论坛、社交媒体或社区平台上有与搜索查询相关的帖子。该部分通常展示来自 Reddit、TikTok 和其他讨论论坛等平台的内容。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-2b956b0f3bc6e66d34b2df1070f254b500e15f84%2FScreenshot%202025-05-30%20at%2010.24.15.png?alt=media" alt=""><figcaption></figcaption></figure>

```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 人队的主场其实离旧金山很远。没有交通拥堵时，从旧金山市中心开车到李维斯体育场大约需要一小时。乘坐公共交通（也可以搭配 Uber/Lyft）需要 90 到 120 分钟。\n* 我建议住在旧金山市内。如果不想住在旧金山，住在 BART 附近也可以方便观光，而且花费不高。\n* 在旧金山，请注意田德隆区是个治安很差的社区。你经常会在福克斯新闻上看到那些讲“旧金山失控了”的报道，地点就是那里。市里的其他地方都很安全，也相当干净。\n* 旧金山西侧，尤其是日落区，公共交通连接较少。不租车也完全可以四处走走，但去市中心或铁路系统会多花一些时间。\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，旧金山 #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"
                            }
                        ]
                    }
...
```

<table><thead><tr><th width="279">键（results.what_people_are_saying）</th><th width="256">描述</th><th width="91">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>包含所有讨论论坛或社交媒体内容项的列表。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>讨论帖或社交媒体内容页面的 URL。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>讨论帖或内容条目的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.top_comments</code></td><td>如果有显示，则为讨论帖中的热门评论。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.source</code></td><td>托管该内容的平台或网站名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.engagement_timeframe</code></td><td>评论数和活跃时间范围（例如，“45 条评论，2 天前”）。</td><td>字符串</td><td>桌面端和移动端</td></tr></tbody></table>

### 搜索信息

“ `search_information` ”功能提供有关搜索查询的结构化信息。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-7c50669770d2180860d0ed43d2f9ad77123fa18d%2FScreenshot%202024-10-29%20at%2013.56.26.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
...
"search_information": {
    "query": "restaurants",
    "geo_location": "10007, New York, NY",
    "showing_results_for": "restaurants",
    "total_results_count": 3200000000
},
...
```

<table><thead><tr><th width="290">键（results.search_information）</th><th width="242">描述</th><th width="95">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>query</code></td><td>原始搜索词。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>geo_location</code> *</td><td>表示与搜索相关的具体地理区域。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>showing_results_for</code></td><td>显示搜索结果所依据的搜索词。如果 Google 自动更正了提供的搜索词，`query` 和 `showing_results_for` 可能会有所不同。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>total_results_count</code></td><td>针对该搜索词找到的结果总数。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

\*仅适用于 JS 渲染

### 商品轮播

页面最顶部会显示一个轮播（`item_carousel`），其中包含与特定类型商品相关的图片或链接。其内容和布局会根据用户的搜索查询而变化，展示一组相关商品。这些商品可能包括产品、新闻和图片，为用户带来视觉效果丰富且个性化的体验。

```json
...
"item_carousel": {
    "items": [
        {
            "pos": 1,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Burj Khalifa 828\u00a0m, 830\u00a0m to tip",
            "subtitle": "828m, 830m to tip"
        },
        {
            "pos": 2,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Warisan Merdeka Tower 679\u00a0m",
            "subtitle": "679m"
        },
...
     ],
    "title": "Buildings (by Height)",
    "pos_overall": 1
},
...
```

<table><thead><tr><th width="252">键（results.item_carousel）</th><th width="293">描述</th><th width="93">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>一个列表，包含轮播中的项目及其相关详情。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>items.pos</code></td><td>项目在轮播中的位置。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>items.href</code></td><td>指向轮播中该项目的 Google 搜索结果页的超链接。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.title</code></td><td>轮播中实体的名称/标题。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.subtitle</code></td><td>对标题中实体的补充说明。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>title</code></td><td>轮播部分的标题。该标题与搜索查询相关。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>商品轮播结果在搜索结果页中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 食谱

Google 上的 `recipes` 搜索结果页功能会在搜索结果顶部展示特定菜肴的烹饪步骤、食材、评分和来源。

```json
...
"recipes": {
    "items": [
        {
            "pos": 1,
            "url": "https://handletheheat.com/chewy-brownies/",
            "desc": "Unsweetened cocoa powder, chocolate chips, baking soda, egg yolk, all purpose flour",
            "title": "Best Ever Chewy Brownies",
            "rating": 4.8,
            "source": "Handle the Heat",
            "duration": "45 mins"
        },
...
    ],
    "pos_overall": 1
},
...
```

<table><thead><tr><th width="199">键（results.recipes）</th><th width="299">描述</th><th width="119">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>一个列表，包含所选食谱及其相关详情。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>食谱在“食谱”搜索结果功能中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>完整食谱的网址。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.desc</code></td><td>从原始文章中提取的食谱简短说明。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.title</code></td><td>食谱的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.rating</code></td><td>食谱的评分。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.source</code></td><td>发布该食谱的网站名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.duration</code></td><td>准备这道菜所需的时间。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>食谱结果在搜索结果页中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 视频

“ `videos` 是 Google 搜索引擎结果页中的一项功能，会展示与用户搜索查询相关的视频精选内容，包括缩略图、标题和来源信息。

```json
...
"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
},
...
```

<table><thead><tr><th width="193">键（results.videos）</th><th width="325">描述</th><th width="90">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>包含视频版块所有结果的列表。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>items.pos</code></td><td>视频在列表中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>items.url</code></td><td>视频链接。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.title</code></td><td>视频的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.author</code></td><td>上传该视频的个人资料名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>items.source</code></td><td>托管该视频的平台名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>视频结果在搜索引擎结果页（SERP）中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 精选摘要

&#x20;`featured_snippet` 是 Google 搜索结果中的一种特殊结果，会在指向页面的链接之前显示对该页面的简要描述。这些重点展示的结果位于自然搜索结果顶部，让用户能够快速获取相关信息。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-ee5afc45650abc4dffb62a943cad9c10cf9aeebf%2Fgoogle_search_11.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
...
"featured_snippet": [
    {
        "url": "https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors",
        "desc": "随着秋季夜晚变长，叶绿素的生成会减缓，随后停止，最终叶绿素会全部分解。此时，叶片中已有的类胡萝卜素和花青素显露出来，呈现出它们的颜色。",
        "title": "Science of Fall Colors | US Forest Service",
        "url_shown": "https://www.fs.usda.gov\u203a visit \u203a science-of-fall-colors",
        "pos_overall": 1
    }
],
...
```

<table><thead><tr><th width="272">键（results.featured_snippet）</th><th width="263">描述</th><th width="98">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>url</code></td><td>提取页面描述摘要的网站 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>desc</code></td><td>包含特定搜索结果描述的摘要。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>title</code></td><td>提取页面描述摘要的文章名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>url_shown</code></td><td>搜索引擎结果页（SERP）中可见的精选摘要所在网站的 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>精选摘要结果在搜索引擎结果页（SERP）中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 酒店

Google `hotels` 是一项直接在搜索结果中展示酒店信息的功能。当用户在 Google 上搜索酒店或住宿相关内容时，搜索引擎可能会在结果页顶部显示专门的酒店模块，醒目且便捷地概览相关选项。

```json
...
"hotels": {
    "date_to": "Mon, 11 Dec",
    "results": [
        {
            "price": "£54",
            "title": "Hilton Garden Inn Vilnius City Centre",
            "description": "配有餐厅/酒吧的现代酒店"
        },
        {
            "price": "£57",
            "title": "Radisson Blu Hotel Lietuva",
            "description": "设有水疗中心和餐饮设施的现代高层酒店"
        },
       ...
    ],
    "date_from": "Sun, 10 Dec",
    "pos_overall": 5
},
...
```

<table><thead><tr><th width="241">键（results.hotels）</th><th width="309">描述</th><th width="89">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>date_to</code></td><td>退房日期。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>results</code></td><td>包含酒店所有详细信息的列表。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>results.price</code></td><td>酒店的价格。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>results.title</code></td><td>酒店的名称。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>results.description</code></td><td>显示在酒店名称正下方的简短描述。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>date_from</code></td><td>入住日期。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>表示 Hotels 结果在 SERP 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 航班

&#x20;`flights`  功能会展示一个区块，其中包含与相关搜索查询对应的、经过整理的航班选项，让用户可以直接在搜索结果中比较这些选项。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-6662f479b198378c3f7ed82931eed79814438a18%2Fgoogle_search_6.png?alt=media" alt=""><figcaption></figcaption></figure>

```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": "Nonstop",
            "price": "$423",
            "airline": "Norse Atlantic UK",
            "duration": "6h 50m"
        },
       ...
    ],
    "date_from": "1月22日，周一",
    "pos_overall": 1
},
...
```

<table><thead><tr><th width="210">键 (results.flights)</th><th width="311">描述</th><th width="105">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>to</code></td><td>到达机场。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>from</code></td><td>出发机场。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>date_to</code></td><td>到达日期。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>results</code></td><td>包含所选航班及其相应详细信息的列表。</td><td>数组</td><td>桌面端和移动端</td></tr><tr><td><code>results.url</code></td><td>指向 Google Flights 页面链接，该页面列出某家航空公司的所有航班。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>results.type</code></td><td>航班类型。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>results.price</code></td><td>航班价格。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>results.airline</code></td><td>承运航空公司的名称。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>results.duration</code></td><td>航班时长。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>date_from</code></td><td>出发日期。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>pos_overall</code></td><td>表示 Flights 结果在 SERP 中的位置。</td><td>整数</td><td>桌面端和移动端</td></tr></tbody></table>

### 视频框

&#x20;`video_boxes`  数组包含搜索结果页顶部的特定视频结果，这些结果由 Google 选出，被认为与查询最相关。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-db3f96c0be48ead444e6df65f98117d5dd9220e7%2Fgoogle_video_box.png?alt=media" alt=""><figcaption></figcaption></figure>

```json
...
"video_boxes": [
  {
    "pos_overall": 1,
    "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K ...",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  },
  {
    "pos_overall": 2,
    "title": "Rick Astley - Never Gonna Give You Up 1987 (Official Music ...",
    "url": "https://www.youtube.com/watch?v=jzmz6K8K4L0"
  }
]
...
```

<table><thead><tr><th width="223">键（results.video_boxes）</th><th width="294">描述</th><th width="93">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>pos_overall</code></td><td>视频框的整体位置。</td><td>整数</td><td>桌面端和移动端</td></tr><tr><td><code>title</code></td><td>视频的标题。</td><td>字符串</td><td>桌面端和移动端</td></tr><tr><td><code>url</code></td><td>视频的 URL。</td><td>字符串</td><td>桌面端和移动端</td></tr></tbody></table>

### 本地服务广告

此 `local_service_ads` 功能使水管工、电工、锁匠和其他本地服务提供商等面向服务的专业人士，能够在 Google 搜索结果页上推广他们的服务。

<pre class="language-json"><code class="lang-json"><strong>...
</strong><strong>"local_service_ads": {
</strong>    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall &#x26; Katt, Attorneys at Law",
            "rating": 4.4,
            "reviews_count": 254
        },
       ...
    ],
    "pos_overall": 2
},
...
</code></pre>

<table><thead><tr><th width="278">键（results.local_service_ads）</th><th width="264">描述</th><th width="106">类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>服务提供商列表及其各自的详细信息。</td><td>数组</td><td>桌面端</td></tr><tr><td><code>items.pos</code></td><td>服务广告在本地服务广告 SERP 功能中的位置。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>items.url</code></td><td>指向本地服务搜索页中该服务的链接。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.title</code></td><td>服务提供商的名称。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.rating</code></td><td>服务提供商的评分。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>items.reviews_count</code></td><td>服务提供商的评论数量。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>本地服务广告结果在 SERP 中的位置指示。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

### 应用

此 `apps` SERP 功能会根据用户的查询显示相关应用，并提供价格、评分等关键信息。此功能为应用开发者和发布者提供了一个有价值的平台，可直接在 Google 搜索结果页上提升其移动应用的曝光度和互动率。

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-e986e53f04e1ae26771b1e82be9d2f249805147a%2Fgoogle_search_8.png?alt=media" alt=""><figcaption></figcaption></figure>

```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"
    }
],
...
```

<table><thead><tr><th width="241">键（results.apps）</th><th width="304">描述</th><th>类型</th><th>布局</th></tr></thead><tbody><tr><td><code>id</code></td><td>应用在可用应用商店中的 ID。</td><td>字符串</td><td>移动设备</td></tr><tr><td><code>url</code></td><td>SERP 中应用商店的 URL，其中包含应用的完整信息。</td><td>字符串</td><td>移动设备</td></tr><tr><td><code>title</code></td><td>应用的名称。</td><td>字符串</td><td>移动设备</td></tr><tr><td><code>rating</code></td><td>应用的评分。</td><td>整数</td><td>移动设备</td></tr><tr><td><code>reviews_count</code></td><td>应用商店中 Apps SERP 结果的评论总数。</td><td>整数</td><td>移动设备</td></tr><tr><td><code>items.reviews_count</code></td><td>服务提供商的评论数量。</td><td>字符串</td><td>移动设备</td></tr></tbody></table>

### **金融**

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

#### **HTML 示例**

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-5a19dab4faf8cfe21c59b9f396ac6b5a8fa42d67%2Fgoogle_search_2.png?alt=media" alt=""><figcaption></figcaption></figure>

| 键（results.finance）    | 描述                           | 类型  | 布局  |
| --------------------- | ---------------------------- | --- | --- |
| `low`                 | 指定日期的最低价格。                   | 浮点数 | 桌面端 |
| `date`                | 报告净资产价值的日期。                  | 字符串 | 桌面端 |
| `high`                | 指定日期的最高价格                    | 浮点数 | 桌面端 |
| `open`                | 指定日期的开盘价                     | 浮点数 | 桌面端 |
| `source`              | 相关 Google Finance 来源网站的 URL。 | 字符串 | 桌面端 |
| `difference`          | 最近一次报告的净资产值与紧接其前一次报告的净资产值之差。 | 字符串 | 桌面端 |
| `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": "Apr 25, 8:09AM 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
},
...
```

### 体育比赛

近期体育赛事的信息，包括比分、参赛队伍、比赛类型和精彩集锦。

<table><thead><tr><th width="231">键（results.sports_games）</th><th width="271">描述</th><th>类型</th><th>布局</th></tr></thead><tbody><tr><td><code>games</code></td><td>包含多场体育比赛信息的数组</td><td>数组</td><td>桌面端</td></tr><tr><td><code>games.date</code></td><td>比赛计划举行或实际举行的日期和时间</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>games.teams</code></td><td>参赛队伍</td><td>数组</td><td>桌面端</td></tr><tr><td><code>games.game_type</code></td><td>比赛类型，例如常规赛、季后赛、锦标赛等。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>games.highlight</code></td><td>比赛精彩集锦的链接，例如关键进攻、进球等。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>games.teams.score</code></td><td>各队在比赛中取得的分数</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>games.teams.winner</code></td><td>指定赢得比赛的队伍</td><td>布尔值</td><td>桌面端</td></tr><tr><td><code>games.teams.team_name</code></td><td>显示参与比赛的球队名称</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>stage</code></td><td>体育赛事或锦标赛的具体阶段。</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>league</code></td><td>指负责组织该赛事的体育联盟或机构</td><td>字符串</td><td>桌面端</td></tr></tbody></table>

#### **JSON 示例**

```json
...                 
"sports_games": {
    "games": [
  		...
                {
            "date": "Yesterday",
            "teams": [
                {
                    "score": "75",
                    "winner": false,
                    "team_name": "Barcelona"
                },
                {
                    "score": "77",
                    "winner": true,
                    "team_name": "Olympiacos"
                }
            ],
            "game_type": "Final",
            "highlight": "https://stories.euroleague.net/games/329003-20240424-Barcelona-vs-Olympiacos-Piraeus.html"
        },
    				...
    ],
    "stage": "Quarter-final",
    "league": "EuroLeague"
},
...
```

### 讨论和论坛

讨论串和论坛帖子的列表，包含网址、标题、来源和评论数。

#### **HTML 示例**

<figure><img src="https://3714446197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-9b82fce7c80d7b35f801f886fffc49939fef8a17%2Fgoogle_search_4.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="202">键 (results.discussions_and_forums)</th><th width="360">描述</th><th>类型</th><th>布局</th></tr></thead><tbody><tr><td><code>items</code></td><td>Google 已编入索引的论坛或讨论串中的条目数组</td><td>数组</td><td>桌面端</td></tr><tr><td><code>items.pos</code></td><td>表示某条结果在所有“讨论和论坛”结果中的位置。</td><td>整数</td><td>桌面端</td></tr><tr><td><code>items.url</code></td><td>指向特定论坛帖子或讨论串的网址链接</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.title</code></td><td>论坛帖子或讨论主题的标题</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.source</code></td><td>托管该论坛或讨论内容的来源</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.timeframe</code></td><td>论坛帖子或讨论内容的时间范围或日期</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>items.comments_count</code></td><td>论坛帖子或讨论串收到的评论或回复数量</td><td>字符串</td><td>桌面端</td></tr><tr><td><code>pos_overall</code></td><td>表示“讨论和论坛”SERP 功能在 SERP 中的位置。</td><td>整数</td><td>桌面端</td></tr></tbody></table>

#### **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": "1y",
            "comments_count": "20+ comments"
        },
        ...
    ],
    "pos_overall": 7
}
},
...
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/sou-suo-yin-qing/gu-ge/sou-suo/wang-ye-sou-suo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
