网页搜索

全面的 Google Search 抓取器，提供自然结果、广告、摘要、知识面板、热门报道等的解析数据。

该 google_search 源旨在检索 Google Search（SERPs）和 Google AI Overviews 结果。此子页面专门介绍与 Google Web Search 相关的信息。要了解其他结果类型，请阅读 图片搜索 或 新闻搜索.

请求示例

在以下示例中，我们发起一个请求以获取 2 结果页面，从第 11 到第 12 ，搜索词为 adidas。API 将返回解析后的结果。

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,
    }'

import requests
from pprint import pprint


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


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

# 将美化后的响应打印到标准输出。
pprint(response.json())

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: "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();

<?php

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

$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);

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://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))
}

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://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);
        }
    }
}

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

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

请求参数值

通用

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

参数

说明

默认值

source

设置爬虫。

google_search

query

要搜索的关键词或短语。

render

设置为 html. 更多信息.

parse

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

false

callback_url

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

user_agent_type

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

desktop

- 必填参数

Google 高级搜索运算符

抓取时，您可能会发现将 Google 高级搜索运算符与您的查询结合使用很有帮助。这样您就可以自定义搜索范围，确保结果更相关、更聚焦。探索这些特殊命令这里和这里。请参见下面的示例。

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

本地化

使搜索结果适配特定地理位置、区域设置和语言。

参数

说明

默认值

geo_location

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

locale

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

分页

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

参数

说明

默认值

start_page

起始页码。

1

pages

要检索的页数。

1

limit

每页要检索的结果数量。

10

context:limit_per_page

使用相同的 IP 地址和会话（Cookie 集）抓取多个页面。通过在 JSON 数组中使用 page 键指定页码，并使用 limit 键指定每页的自然结果数量，您可以尽量减少跨页看到重复自然结果的可能性（例如，第一页的最后一个自然结果与第二页的第一个自然结果相同）。 查看示例.

支持连续滚动

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

每页限制

由于 Google 最近的限制变更，我们已调整网页爬虫API 的行为。每页最大结果数将与 Google 的自然输出一致，通常为 10 条结果。

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

参数

说明

示例

page

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

1

limit

该页上的结果数量。任何介于 1 和 100 之间（含端点）的整数值都可以。

90

请求示例

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

筛选

根据各种条件筛选和优化搜索结果的选项。了解如何使用 context 参数这里.

参数

说明

默认值

context: filter

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

1

context: safe_search

安全搜索。设置为 true 即可启用。

false

context: udm

udm 参数允许在不同搜索标签之间切换，例如图片、地点或视频，以自定义显示的结果类型。可接受的值见这里.

context: tbm

To-be-matched 或 tbm 参数。可接受的值包括： app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

context: tbs

此参数类似于一个容器，用于承载更冷门的 google 参数，例如按日期限制/排序结果，以及其他一些筛选器，其中部分取决于 tbm 参数（例如 tbs=app_os:1 仅在 tbm 值下可用 app）。更多信息这里.

udm 和 tbm context 参数不能在单个抓取请求中同时使用；请只选择一个。同时使用两者可能导致冲突或意外行为。

其他

适用于专门需求的其他高级设置和控制项。

参数

说明

默认值

context: fpstate

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

context: nfpr

true 将关闭拼写自动更正

false

Context 参数

所有 context 参数都应作为带有 context 对象添加到 key 和 值下可用 对的数组中，例如：

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

结构化数据

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

google_search 结构化输出

{
    "results": [
        {
            "content": {
                "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
                "page": 1,
                "results": {
                    "pla": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/nmd_r1-primeblue-shoes/GZ9257.html?dfw_tracker=24819-GZ9257-0010",
                                "price": "$150.00",
                                "title": "NMD_R1 Primeblue Shoes Black M 8.5 / W 9.5 - 男士 Originals 鞋款",
                                "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 - 儿童 Originals 鞋款",
                                "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 官方网站 | 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": "YOUR 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
                    },
                    "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 Comfort 拖鞋 - 米色 | women swim | adidas US",
                                "source": "",
                                "timeframe": "8 小时前"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "女装最高可享 5 折优惠 | adidas US",
                                "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 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"
        }
    ]
}

元素的组成可能会因其是 desktop 或 移动端 搜索而有所不同。

为帮助你识别某些元素，请参考每种 Google 搜索结果类型的数据字典，无论这些结果来自桌面端还是移动端搜索。

输出数据字典

可通过右侧导航或向下滚动页面来浏览详细信息。

HTML 示例

JSON 结构

Google Web Search 结构化输出包含诸如 URL, page, results等字段。下表列出了我们解析的每个 SERP 功能的详细清单，以及其描述和数据类型。该表还包含一些元数据。

特定结果类型的项目数和字段数可能因搜索查询而异。

键名

说明

类型

url

Google 搜索页面的 URL。

字符串

page

相对于 Google SERP 分页的页码。

整数

results

包含搜索结果的字典。

对象

results.pla

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

对象

results.paid

包含各自详细信息的赞助结果列表。

数组

results.images

包含各自详细信息的图片结果列表。

对象

results.flights

包含各自详细信息的航班列表。

对象

results.organic

包含各自详细信息的自然结果列表。

数组

results.organic_videos

包含各自详细信息的自然视频列表。

数组

results.top_sights

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

数组

results.jobs

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

对象

results.local_service_ads

赞助的本地服务提供商列表。

对象

results.video_boxes

SERP 中的视频框及其各自的详细信息。

数组

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_products

Google 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 内容的解析器类型。

字符串

在以下部分中，当某种结果类型包含多个项目时，解析后的 JSON 代码片段会被缩短。

商品列表广告 (PLA)

该 pla 搜索结果部分指的是商品列表广告，也称为 Google Shopping 广告，通常以轮播形式突出显示在搜索页面顶部。

...
"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）

说明

类型

布局

项目

页面内可用的所有 PLA。

数组

桌面端和移动端

items.pos

表示某个项目在 PLA 结果中的位置的指示器。

整数

桌面端和移动端

items.url

商品的 URL。

字符串

桌面端和移动端

items.price

列表广告中商品的价格。

字符串

桌面端和移动端

items.title

列表广告中商品的标题。

字符串

桌面端和移动端

items.seller

列表广告中商品的卖家。

字符串

桌面端和移动端

items.url_image

商品图片的 URL。

字符串

桌面端

items.image_data

商品的 base64 编码缩略图。

字符串

桌面端和移动端

pos_overall

表示 PLA SERP 功能在 SERP 中的位置。

整数

桌面端和移动端

付费

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

... 
"paid": [
    {
        "pos": 1,
        "url": "https://www.adidas.com/us/cyber_monday",
        "desc": "最后抢购网络促销。使用代码 CYBERSALE，额外 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": "最后抢购网络促销。使用代码 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 \u203a official \u203a site",
        "pos_overall": 1
    }
],
...

键（results.paid）

说明

类型

布局

pos

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

整数

桌面端和移动端

url

付费结果的 URL。

字符串

桌面端和移动端

desc

付费结果的简短描述。

字符串

桌面端和移动端

title

付费结果的标题。

字符串

桌面端和移动端

data_rw

付费结果的重定向 URL。

字符串

桌面端和移动端

sitelinks

一个包含指向网站的内部链接信息的对象，该网站显示在 Google 的第一个搜索结果下方。

对象

桌面端和移动端

sitelinks.inline/expanded

一个包含各自详细信息的 URL 列表。键名（`inline`/`expanded`）指定该 sitelinks 元素。

数组

桌面端和移动端

sitelinks.inline.url

链接站点的 URL。

字符串

桌面端和移动端

sitelinks.inline.title

链接站点的标题。

字符串

桌面端和移动端

sitelinks.inline.description

链接站点的简短描述。

字符串

桌面端

url_shown

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

字符串

桌面端和移动端

pos_overall

付费结果在 SERP 中的位置指示。

整数

桌面端和移动端

图片

该 images section 指的是显示在 SERP 页面不同部分的图片结果，可以是专门的部分，也可以是在顶部。需要注意的是，来自 Google Search 结果的抓取数据结构可能与来自 Google Image Search 结果的抓取数据结构不同。

...
"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）/ X",
            "pos": 3,
            "url": "https://twitter.com/adidas"
        }
    ],
    "pos_overall": 4
},
...

键（results.images）

说明

类型

布局

项目

一组图片及其各自的详细信息。

数组

桌面端和移动端

items.alt

图片的替代文本。

字符串

桌面端和移动端

items.pos

用于表示列表中图片位置的唯一标识。

整数

桌面端和移动端

items.url

包含该图片的网页 URL。

字符串

桌面端和移动端

pos_overall

表示 Images SERP 功能在 SERP 中位置的指示。

整数

桌面端和移动端

自然

该 organic section 指的是 Google 自然搜索结果中的未付费列表，其排名由 Google 的算法根据相关性确定。这些列表显示在搜索页面上的付费广告下方。

示例 1

...
"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-Cookie/", 
                    "title": "完美的燕麦Cookie"
                }
            ]
        },
        "url_shown": "https://www.loveandlemons.com\u203a 食谱",
        "pos_overall": 2
    },
...

示例 2

...
"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\u203a classics-winter-track-jacket",
        "desc": "一款柔软的 sherpa 训练夹克，源自户外冬季运动 \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 天免费退货"
        ]
    },
...

键（results.organic）

说明

类型

布局

pos

用于表示某个项目在自然搜索结果中的位置的指示符。

整数

桌面端和移动端

url

自然搜索结果的 URL。

字符串

桌面端和移动端

desc

自然搜索结果的简短描述。

字符串

桌面端和移动端

title

自然搜索结果的标题。

字符串

桌面端和移动端

images

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

字符串

桌面端和移动端

sitelinks

对象包含带有站内链接更多详情的 `expanded` 或 `inline` 元素。

对象

桌面端和移动端

sitelinks.expanded/inline

自然搜索结果的站内链接列表。键名（inline/expanded）指定站内链接元素的类型。

数组

桌面端和移动端

sitelinks.expanded.url

链接站点的 URL。

字符串

桌面端和移动端

sitelinks.expanded.title

链接站点的标题。

字符串

桌面端和移动端

url_shown

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

字符串

桌面端和移动端

pos_overall

表示自然搜索结果在 SERP 中的位置。

整数

桌面端和移动端

favicon_text

与 favicon（网站图标）关联的文本或名称。

字符串

桌面端

rating

产品或内容的平均评分。

浮点数

桌面端

review_count

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

整数

桌面端

additional_info

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

字符串列表

桌面端

自然视频

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

...
 "organic_videos": [
    {
        "pos": 1,
        "url": "https://www.youtube.com/watch?v=XHTrLYShBRQ",
        "desc": "你的浏览器无法播放此视频。了解更多。",
        "title": "介绍 iPhone 15 | WOW | Apple - YouTube",
        "pos_overall": 6
    },
...

键（results.organic_videos）

说明

类型

布局

pos

用于表示某个项目在自然视频结果中的位置的指示符。

整数

桌面端

url

视频的 URL。

字符串

桌面端

desc

视频的简短描述。

字符串

桌面端

title

视频的标题。

字符串

桌面端

pos_overall

Organic Video 结果在 SERP 中的位置指示。

整数

桌面端

职位

该 results.jobs 包含从搜索结果中提取的职位列表。每个列表项都包括指向职位发布页面的 URL、职位标题、来源、雇主和地点等详细信息。这些列表来自 Google 索引的各种招聘网站、职业网站和其他平台。

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

键（results.jobs）

说明

类型

布局

listings

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

数组

桌面端

listings.url

完整职位列表的 URL。

字符串

桌面端

listings.title

职位名称。

字符串

桌面端

listings.source

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

字符串

桌面端

listings.employer

招聘该职位的组织。

字符串

桌面端

listings.location

该职位的地点。

字符串

桌面端

pos_overall

Jobs SERP 特性在 SERP 中的位置指示。

整数

桌面端

Twitter（X）

该 twitter 该特性常用于品牌、电影、音乐人和其他名人，通常直接显示在品牌网站搜索结果下方。此特性提供指向品牌 Twitter 动态的直接链接，并展示其最新推文的轮播。

...
"twitter": {
    "pos": 1,
    "url": "https://twitter.com/NintendoAmerica",
    "items": [
        {
            "pos": 1,
            "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
            "content": "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
},
...

键（results.twitter）

说明

类型

布局

pos

用于表示某个项目在自然搜索结果中的位置的指示符。

整数

桌面端

url

包含 Twitter（X）帖子资料的 URL。

字符串

桌面端

项目

包含 Twitter（X）帖子及其对应详细信息的列表。

数组

桌面端

items.pos

表示某条推文在 Twitter（X）SERP 特性中的位置的指示。

字符串

桌面端

items.url

Twitter（X）帖子的 URL。

字符串

桌面端

items.content

一个简短描述，表示相关 Twitter（X）帖子中的全部文本。

字符串

桌面端

items.timeframe

描述推文创建于多久之前。

字符串

桌面端

title

Twitter（X）个人资料的标题。

字符串

桌面端

pos_overall

表示 Twitter 结果在 SERP 中的位置。

整数

桌面端

知识

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

...
"knowledge": {
    "title": "Adidas",
    "images": [
        "iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..."
    ],
    "factoids": [
        {
            "links": [
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Founder"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Adolf Dassler"
                }
            ],
            "title": "Founder",
            "content": "Adolf Dassler"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "Apparel company",
    "description": "Description阿迪达斯股份公司是一家德国运动服装和鞋类企业，总部位于德国巴伐利亚州黑措根奥拉赫。它是欧洲最大的运动服装制造商，也是全球第二大，仅次于 Nike。Wikipedia",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "其他人还搜索"
        },
        ...
    ]
},
...

键（results.knowledge）

说明

类型

布局

title

知识面板的标题。

字符串

桌面端和移动端

images

紧邻标题旁边使用的图片列表。

数组

桌面端

事实项

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

数组

桌面端和移动端

factoids.links

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

数组

桌面端和移动端

factoids.links.href

指向给定事实项的 Google 搜索结果页的超链接。

字符串

桌面端和移动端

factoids.links.title

与该事实项相关的任何链接页面的描述。

字符串

桌面端和移动端

factoids.title

事实项部分的名称。

字符串

桌面端和移动端

factoids.content

事实项的描述。

字符串

桌面端和移动端

profiles

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

字符串

桌面端

profiles.url

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

字符串

桌面端

profiles.title

该社交媒体资料的标题。

字符串

桌面端

副标题

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

字符串

桌面端和移动端

描述

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

字符串

桌面端和移动端

related_searches

相关搜索及其各自详细信息的列表。

数组

桌面端

related_searches.url

本地信息栏

该 local_pack 根据用户位置或指定搜索位置显示前三个本地搜索结果，包括地图和附加信息。

...
"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.cid

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

字符串

桌面端和移动端

items.pos

本地结果在本地信息栏中的位置。

整数

桌面端和移动端

items.title

本地实体的标题。

字符串

桌面端和移动端

items.rating

本地实体的评分。

整数

桌面端和移动端

items.address

本地实体的地址。

字符串

桌面端和移动端

items.rating_count

本地实体的评分数量。

整数

桌面端和移动端

pos_overall

本地信息栏结果在 SERP 中的整体位置指示。

整数

桌面端和移动端

大家在说什么

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

...
"what_people_are_saying": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.reddit.com/r/travel/comments/1kxf875/san_francisco_hotels/",
                                "title": "San Francisco hotels",
                                "top_comments": "Welcome to SF! A couple of notes.\n* October is normally our best weather all year. Great plan! (Anyone else reading this: \"summer\" in SF is typically very, very foggy and cold.)\n* (This is probably super obvious, so apologies in advance. Maybe it'll be helpful for someone else reading this.) The Niners don't actually play anywhere near SF. With no traffic, the drive from downtown SF to Levi's is about an hour. On public transit (maybe with Uber/Lyft assisting) it's 90-120 minutes.\n* I'd recommend staying in the city of SF itself. If you don't want to be in SF, then somewhere close to BART will allow you to sightsee without spending much money.\n* Within SF, be aware that the Tenderloin is a very rough neighborhood. That's the place you always see on Fox News with \"out of control San Francisco\" stories. The rest of the city is safe and fairly clean.\n* The west side of SF, and especially the Sunset, is less connected to public transit. You can definitely get around without a car, but it'll take you a bit longer to get downtown or to train systems.\nCongrats on the retirement! Sounds like a nice reward.",
                                "source": "Reddit",
                                "engagement_timeframe": "10+ comments, 1 week ago"
                            },
                            {
                                "pos": 2,
                                "url": "https://www.tiktok.com/@kaorihatsusee/video/7501124173717065006",
                                "title": "Honestly enjoyed our stay here 🫶🏼 @maya hangai 📍Kasa La Monarca, San Francisco #affordable #affordablehotel #hotel #sanfrancisco"
                                "source": "TikTok",
                                "engagement_timeframe": "45.3K+views, 3 weeks ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco",
                                "title": "23 Best Hotels in San Francisco, From Mission Bay to the Castro District"
                                "source": "Condé Nast Traveller",
                                "engagement_timeframe": "1 month ago"
                            }
                        ]
                    }
...

键（results.what_people_are_saying）

说明

类型

布局

项目

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

数组

桌面端和移动端

items.url

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

整数

桌面端和移动端

items.title

讨论线程或内容片段的标题。

字符串

桌面端和移动端

items.top_comments

如果显示，则为讨论线程中的热门评论。

字符串

桌面端和移动端

items.source

承载内容的平台或网站名称。

字符串

桌面端和移动端

items.engagement_timeframe

评论数量和活动时间范围（例如，“45 条评论，2 天前”）。

字符串

桌面端和移动端

搜索信息

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

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

键（results.search_information）

说明

类型

布局

query

原始搜索词。

字符串

桌面端和移动端

geo_location *

表示与搜索相关的特定地理区域。

字符串

桌面端

showing_results_for

显示搜索结果所对应的搜索词。如果 Google 自动更正了提供的搜索词，`query` 和 `showing_results_for` 可能不同。

字符串

桌面端和移动端

total_results_count

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

整数

桌面端和移动端

*仅在使用 JS 渲染时有效

项目轮播

一个（item_carousel）与特定类型项目相关的图片或链接轮播，显示在 SERP 最顶部。内容和布局会根据用户的搜索查询而变化，展示一组相关项目。这可以涵盖产品、新闻到图片等，为用户创建一个视觉上更吸引人且定制化的体验。

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

键（results.item_carousel）

说明

类型

布局

项目

包含轮播中项目及其详细信息的列表。

数组

桌面端

items.pos

项目在轮播中的位置。

整数

桌面端

items.href

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

字符串

桌面端

items.title

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

字符串

桌面端

items.subtitle

标题中实体的附加详情。

字符串

桌面端

title

轮播部分的标题。标题与搜索查询相关。

字符串

桌面端

pos_overall

表示项目轮播结果在 SERP 中的位置指示。

整数

桌面端

食谱

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

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

键（results.recipes）

说明

类型

布局

项目

包含所选食谱及其详细信息的列表。

数组

桌面端和移动端

items.pos

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

整数

桌面端和移动端

items.url

完整食谱的 URL。

字符串

桌面端和移动端

items.desc

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

字符串

桌面端

items.title

食谱标题。

字符串

桌面端和移动端

items.rating

食谱评分。

整数

桌面端和移动端

items.source

食谱所在网站的名称。

字符串

桌面端和移动端

items.duration

准备这道菜所需的时间。

字符串

桌面端和移动端

pos_overall

表示食谱结果在 SERP 中的位置指示。

整数

桌面端和移动端

视频

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

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

键（results.videos）

说明

类型

布局

项目

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

数组

桌面端和移动端

items.pos

视频在列表中的位置。

整数

桌面端和移动端

items.url

视频链接。

字符串

桌面端和移动端

items.title

视频的标题。

字符串

桌面端和移动端

items.author

视频上传的资料名称。

字符串

桌面端和移动端

items.source

承载视频的平台名称。

字符串

桌面端和移动端

pos_overall

表示视频结果在 SERP 中的位置指示。

整数

桌面端和移动端

精选摘要

该 featured_snippet 是一种独特的 Google 搜索结果，在页面链接之前显示简短摘要来描述该页面。这些高亮结果会突出显示在自然搜索结果顶部，为用户快速获取相关信息。

...
"featured_snippet": [
    {
        "url": "https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors",
        "desc": "As night length increases in the autumn, chlorophyll production slows down and then stops and eventually all the chlorophyll is destroyed. The carotenoids and anthocyanin that are present in the leaf are then unmasked and show their colors.",
        "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
    }
],
...

键（results.featured_snippet）

说明

类型

布局

url

用于提取页面描述摘要的网站 URL。

字符串

桌面端和移动端

desc

包含特定搜索结果描述的摘要。

字符串

桌面端和移动端

title

提取页面描述摘要的文章名称。

字符串

桌面端和移动端

url_shown

SERP 中可见的、包含精选摘要的网站 URL。

字符串

桌面端和移动端

pos_overall

表示精选摘要结果在 SERP 中的位置指示。

整数

桌面端和移动端

键（results.related_searches_categorized）

说明

类型

布局

项目

包含从 SERP 中水平轮播检索到的所有相关搜索项的列表。

数组

桌面端

items.url

酒店

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

...
"hotels": {
    "date_to": "Mon, 11 Dec",
    "results": [
        {
            "price": "£54",
            "title": "Hilton Garden Inn Vilnius City Centre",
            "description": "Modern hotel with a restaurant/bar"
        },
        {
            "price": "£57",
            "title": "Radisson Blu Hotel Lietuva",
            "description": "Modern high-rise with a spa & dining"
        },
       ...
    ],
    "date_from": "Sun, 10 Dec",
    "pos_overall": 5
},
...

键（results.hotels）

说明

类型

布局

date_to

退房日期。

字符串

桌面端

results

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

数组

桌面端

results.price

酒店价格。

字符串

桌面端

results.title

酒店名称。

字符串

桌面端

results.description

酒店名称下方可见的酒店简短描述。

字符串

桌面端

date_from

入住日期。

字符串

桌面端

pos_overall

表示酒店结果在 SERP 中的位置指示。

整数

桌面端

航班

该 flights 该功能展示一个包含与相关搜索查询有关的有序航班选项的模块，允许用户直接在搜索结果中比较选项。

...
"flights": {
    "to": "London, United Kingdom (all airports)",
    "from": "New York, NY (all airports)",
    "date_to": "Mon, Jan 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": "Mon, Jan 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 选为与查询最相关的内容。

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

键（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.pos

服务广告在本地服务广告 SERP 功能中的位置。

整数

桌面端

items.url

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

字符串

桌面端

items.title

服务提供者的标题。

字符串

桌面端

items.rating

服务提供者的评分。

整数

桌面端

items.reviews_count

服务提供者的评论数量。

整数

桌面端

pos_overall

表示本地服务广告结果在 SERP 中的位置指示。

整数

桌面端

应用

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

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

键（results.apps）

说明

类型

布局

id

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

字符串

移动端

url

包含该应用完整信息、位于 SERP 中的应用商店 URL。

字符串

移动端

title

应用标题。

字符串

移动端

rating

应用评分。

整数

移动端

reviews_count

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

整数

移动端

items.reviews_count

服务提供者的评论数量。

字符串

移动端

金融

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

HTML 示例

键（results.finance）

说明

类型

布局

低点

指定日期的最低价格。

浮点数

桌面端

date

报告净资产价值的日期。

字符串

桌面端

高点

指定日期的最高价格。

浮点数

桌面端

开盘

指定日期的开盘价。

浮点数

桌面端

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 示例

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

体育比赛

近期体育赛事信息，包括比分、球队、比赛类型和亮点。

HTML 示例

键（results.sports_games）

说明

类型

布局

games

提供多场体育比赛信息的数组

数组

桌面端

games.date

比赛计划举行或已发生的日期和时间

字符串

桌面端

games.teams

比赛中涉及的队伍

数组

桌面端

games.game_type

正在进行的比赛类型，例如常规赛、季后赛、冠军赛等。

字符串

桌面端

games.highlight

比赛中的精彩片段链接，例如关键回合、进球等。

字符串

桌面端

games.teams.score

比赛中每支队伍获得的分数或得分

字符串

桌面端

games.teams.winner

指定哪支队伍赢得了比赛

boolean

桌面端

games.teams.team_name

显示比赛中涉及的队伍名称

字符串

桌面端

阶段

体育比赛或锦标赛的具体阶段或轮次。

字符串

桌面端

联赛

指负责监管该比赛的体育联赛或组织

字符串

桌面端

JSON 示例

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

讨论和论坛

包含 URL、标题、来源和评论数的讨论线程与论坛帖子列表。

HTML 示例

键（results.discussions_and_forums）

说明

类型

布局

项目

Google 已索引的论坛或讨论串中的项目或条目数组

数组

桌面端

items.pos

表示某个项目在所有讨论和论坛结果中的位置的标识。

整数

桌面端

items.url

指向具体论坛帖子或讨论串的 URL 链接

字符串

桌面端

items.title

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

字符串

桌面端

items.source

托管该论坛或讨论的来源

字符串

桌面端

items.timeframe

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

字符串

桌面端

items.comments_count

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

字符串

桌面端

pos_overall

表示 Discussions and Forums SERP 功能在 SERP 中的位置。

整数

桌面端

JSON 示例

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

最后更新于 23天前

这有帮助吗？

晚上好

请求示例

请求参数值

通用

Google 高级搜索运算符

本地化

分页

支持连续滚动

每页限制

请求示例

筛选

其他

Context 参数

结构化数据

输出数据字典

JSON 结构

商品列表广告 (PLA)

付费

图片

自然

示例 1

示例 2

自然视频

热门景点

职位

Twitter（X）

知识

本地信息栏

热门新闻

热门商品

相关搜索

相关问题

大家在说什么

搜索信息

项目轮播

食谱

视频

精选摘要

酒店

航班

视频框

本地服务广告

应用

金融

HTML 示例

JSON 示例

体育比赛

HTML 示例

JSON 示例

讨论和论坛

HTML 示例

JSON 示例