网页搜索

功能完整的 Google 搜索爬虫，解析自然结果、广告、摘要、知识面板、热门故事等数据。

该 google_search 源用于获取 Google 搜索（SERP）和 Google AI Overviews 的结果。本子页面专门展示与 Google 网络搜索相关的信息。要查看其他结果类型，请阅读 图像搜索 或 新闻搜索.

请求示例

在下面的示例中，我们发出请求以获取 2 结果页面，从第 11 页到第 12 ，搜索词为 adidas。SERP 将被过滤为仅包含法语结果。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,
        "context": [
            {
                "key": "results_language",
                "value": "fr"
            }
        ]
    }'

import requests
from pprint import pprint


# 构建 payload。
payload = {
    'source': 'google_search',
    'query': 'adidas',
    'start_page': 11,
    'pages': 2,
    'parse': True,
    'context': [
        {'key': 'results_language', 'value': 'fr'},
    ],
}


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

# 将美化后的响应打印到 stdout。
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,
    context: [
        { key: "results_language", value: "fr" },
    ],
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'start_page' => 11,
    'pages' => 2,
    'parse' => true,
    'context' => [
        [
            'key' => 'results_language',
            'value' => 'fr',
        ]
    ]
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":     "google_search",
		"query":      "adidas",
		"start_page": 11,
		"pages":      2,
		"parse":      true,
		"context": []map[string]interface{}{
			{"key": "results_language", "value": "fr"},
		},
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "google_search",
                query = "adidas",
                start_page = 11,
                pages = 2,
                parse = true,
                context = new dynamic [] {
                    new { key = "results_language", value = "fr" },
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_search");
        jsonObject.put("query", "adidas");
        jsonObject.put("start_page", 11);
        jsonObject.put("pages", 2);
        jsonObject.put("parse", true);
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject()
                        .put("key", "results_language")
                        .put("value", "fr"))
        );

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

{
    "source": "google_search",
    "query": "adidas",
    "start_page": 11,
    "pages": 2,
    "parse": true,
    "context": [
        {
            "key": "results_language",
            "value": "fr"
        }
    ]
}

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

请求参数值

通用

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

参数

说明

默认值

source

设置要使用的爬虫源。

google_search

query

要搜索的关键词或短语。

render

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

parse

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

false

callback_url

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

user_agent_type

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

desktop

- 必需参数

Google 高级搜索运算符

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

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

本地化

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

参数

说明

默认值

geo_location

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

locale

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

context: results_language

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

分页

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

参数

说明

默认值

start_page

起始页码。

1

pages

要检索的页数。

1

limit

每页要检索的结果数量。

10

context:limit_per_page

使用相同的 IP 地址和会话（cookie 集）抓取多页。通过在带有 page 键的 JSON 数组中指定页码，并使用 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 参数 here.

参数

说明

默认值

context: filter

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

1

context: safe_search

安全搜索。设置为 true 以启用该功能。

false

context: udm

udm 该参数允许在不同的搜索标签之间切换，例如图像、地点或视频，以自定义显示的结果类型。有关可接受值，请参阅 here.

context: tbm

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

context: tbs

此参数类似于一个容器，用于更不常见的 Google 参数，例如按日期限制/排序结果以及其他某些取决于 tbm 参数（例如 tbs=app_os:1 仅可与 tbm 值 app）一起使用。更多信息 here.

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

其他

用于满足特殊需求的其他高级设置和控制项。

参数

说明

默认值

context: fpstate

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

context: nfpr

true 将关闭拼写自动更正

false

上下文参数

所有上下文参数应作为对象添加到 context 数组中，使用 键和值 和 值 对，例如：

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

结构化数据

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

google_search 结构化输出

{
    "results": [
        {
            "content": {
                "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
                "page": 1,
                "results": {
                    "pla": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/nmd_r1-primeblue-shoes/GZ9257.html?dfw_tracker=24819-GZ9257-0010",
                                "price": "$150.00",
                                "title": "NMD_R1 Primeblue Shoes Black M 8.5 / W 9.5 - Mens Originals Shoes",
                                "seller": "adidas",
                                "url_image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSZALnENHKXERktsOCnUSscRd4v0cSUw9E0XPaZwgyruM0Wuw-MhWcchAVzZRBdS-OP3_167R3jCg&usqp=CAc",
                                "image_data": "iVBORw0KGgoAAAANSUhEU...JRU5ErkJggg=="
                            },
                            {
                                "pos": 22,
                                "url": "https://www.adidas.com/us/ultraboost-5.0-dna-shoes/GY6452.html?dfw_tracker=24819-GY6452-0006",
                                "price": "$90.00",
                                "title": "Ultraboost 5.0 DNA Shoes Magic Grey 13K - Kids Originals Shoes",
                                "seller": "adidas",
                                "url_image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSTCgTZ1im_6ZX9YSCrjQfjVEnTmpmiqqYAHAhXzA9VhJdrokOeOnWsbEOxqA8zPkaos192xPF5ogA&usqp=CAc",
                                "image_data": "iVBORw0KGgoAAAANSUhEU...kJggg=="
                            }
                        ],
                        "pos_overall": 1
                    },
                    "paid": [],
                    "images": {
                        "items": [
                            {
                                "alt": "Image result for adidas",
                                "pos": 1,
                                "url": "/search?q=adidas&gl=us&h...E#imgrc=Dw-CBW17i8BqsM",
                                "source": "https://www.britannica.com/topic/Adidas-AG"
                            },
                            {
                                "alt": "Image result for adidas",
                                "pos": 10,
                                "url": "/search?q=adidas&gl=us&hl=en&tbm=isch&sourXRM%252Cvz-MIh...QF6BAhLEAE#imgrc=_oOH_rR4W_-X-M",
                                "source": "https://www.shutterstock.com/search/adidas"
                            }
                        ],
                        "pos_overall": 11
                    },
                    "organic": [
                        {
                            "pos": 1,
                            "url": "https://www.adidas.com/us",
                            "desc": "adidas 不仅仅是运动服和锻炼服装。我们与业界最佳合作共同创造。通过这种方式，我们为粉丝提供运动用品，...",
                            "title": "adidas 官方网站 | adidas US",
                            "sitelinks": {
                                "expanded": [
                                    {
                                        "url": "https://www.adidas.com/us/women",
                                        "title": "女款"
                                    },
                                    {
                                        "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 是一家德国跨国公司，成立并总部位于巴伐利亚的Herzogenaurach，设计并制造鞋类、服装和配件。它是欧洲最大的运动服饰制造商，也是仅次于 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 拖鞋 - 米色 | 女士泳装 | adidas US",
                                "source": "",
                                "timeframe": "8 小时前"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "女装促销，最高 50% 折扣 | 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 儿童 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 标志",
                                "type": "collapsed"
                            },
                            "pos_overall": 13
                        }
                    ]
                },
                "last_visible_page": 10,
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 07:24:16",
            "updated_at": "2022-05-09 07:24:20",
            "page": 1,
            "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "6929330182268395521",
            "status_code": 200,
            "parser_type": "v2"
        }
    ]
}

元素的组成可能会基于它是否为 desktop 或 移动端 搜索而有所不同。

为帮助你识别特定元素，请参考针对桌面或移动搜索所获取的每种 Google 搜索结果类型的数据字典。

输出数据字典

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

HTML 示例

JSON 结构

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

特定结果类型的条目和字段数量可能根据搜索查询而变化。

键名称

说明

类型

url

Google 搜索页面的 URL。

字符串

page

相对于 Google SERP 分页的页码。

整数

结果

包含搜索结果的字典。

对象

results.pla

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

对象

results.paid

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

数组

results.images

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

对象

results.flights

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

对象

results.organic

包含各自详细信息的非付费列表（自然结果）。

数组

results.organic_videos

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

数组

results.top_sights

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

数组

results.jobs

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

对象

results.local_service_ads

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

对象

results.video_box

包含单个视频项及其详细信息。

对象

results.recipes

包含各自详细信息的食谱列表。

对象

results.twitter

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

数组

results.knowledge

从知识面板检索到的相关信息列表。

对象

results.local_pack

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

对象

results.item_carousel

为信息型查询展示的示例项目列表及其详细信息。

对象

results.videos

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

对象

results.related_searches_categorized

其他用户执行过的相关搜索列表。

数组

results.hotels

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

对象

results.apps

包含各自详细信息的应用列表。

数组

results.finance

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

对象

results.sports_games

关于近期体育赛事的信息，包含比分、队伍、比赛类型和亮点。

对象

results.discussions_and_forums

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

对象

results.featured_snippet

从自然搜索结果中提取的特定结果列表。

数组

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

解析作业的状态代码。你可以查看解析器状态代码的描述 here.

整数

created_at

抓取作业创建的时间戳。

timestamp

updated_at

抓取作业完成的时间戳。

timestamp

job_id

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

字符串

status_code

抓取作业的状态代码。你可以查看爬虫状态代码的描述 here.

整数

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 额外 45% 折扣，适用于促销及全价商品。立即在 adidas® 官方网站购物。加入我们的 adiClub 忠诚计划。会员专属奖励。adiClub 专享。",
        "title": "adidas 官方网站 | 额外 45% 折扣 | 代码 CYBERSALE",
        "data_rw": "https://www.google.com/aclk?...",
        "sitelinks": {
            "expanded": [
                {
                    "url": "https://www.adidas.com/us/shop",
                    "desc": "网络优惠最后机会。使用代码 CYBERSALE 额外 45% 折扣。",
                    "title": "网络星期一促销"
                },
                {
                    "url": "https://www.adidas.com/us/shoes",
                    "desc": "今天找到合适的鞋款。运动与生活方式鞋款可在线购买。",
                    "title": "adidas® 鞋款"
                },
                {
                    "url": "https://www.adidas.com/us/ultraboost",
                    "desc": "惊人的能量回馈，立即购买全新 Ultraboost™ Light。",
                    "title": "adidas® Ultraboost™ Light"
                },
                {
                    "url": "https://www.adidas.com/us/nmd",
                    "desc": "在线购买 adidas Originals 最新 NMD 鞋款发布。",
                    "title": "adidas® NMD"
                }
            ]
        },
        "url_shown": "https://www.adidas.com \u203a official \u203a site",
        "pos_overall": 1
    }
],
...

键 (results.paid)

说明

类型

布局

pos

表示特定项在付费结果中的位置的指标。

整数

桌面与移动

url

付费结果的 URL。

字符串

桌面与移动

desc

付费结果的简短描述。

字符串

桌面与移动

title

付费结果的标题。

字符串

桌面与移动

data_rw

付费结果的重定向 URL。

字符串

桌面与移动

sitelinks

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

对象

桌面与移动

sitelinks.inline/expanded

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

数组

桌面与移动

sitelinks.inline.url

链接站点的 URL。

字符串

桌面与移动

sitelinks.inline.title

链接站点的标题。

字符串

桌面与移动

sitelinks.inline.description

链接站点的简短描述。

字符串

桌面

url_shown

描述下方可见的简短 URL。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

图片

该 images 该部分指在 SERP 页面以专用部分或顶部展示的图片结果。请注意，从 Google 搜索结果抓取到的数据结构可能与从 Google 图片搜索抓取到的数据结构不同。

...
"images": {
    "items": [
        {
            "alt": "Adidas | 历史、产品与事实 | Britannica",
            "pos": 1,
            "url": "https://www.britannica.com/topic/Adidas-AG"
        },
        {
            "alt": "Superstar x Indigo Herz 鞋款",
            "pos": 2,
            "url": "https://www.adidas.com/us/superstar-x-indigo-herz-shoes/IE1842.html"
        },
        {
            "alt": "adidas (@adidas) / X",
            "pos": 3,
            "url": "https://twitter.com/adidas"
        }
    ],
    "pos_overall": 4
},
...

键 (results.images)

说明

类型

布局

条目

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

数组

桌面与移动

items.alt

图片的替代文字（alt 文本）。

字符串

桌面与移动

items.pos

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

整数

桌面与移动

items.url

包含图片的网页的 URL。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

自然结果

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

示例 1

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

示例 2

...
"organic": [
    {
        "pos": 9,
        "pos_overall": 13,
        "title": "Classics 冬季轨道夹克 - 军绿色",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "一件以户外冬季运动为根基的柔软羊羔绒运动夹克 · 宽松版型，休闲且完全不受束缚 · 面料：70% 涤纶 / 30% 回收 ...",
        "favicon_text": "Reebok",
        "images": [
            "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS7NvhUuvYcmAxmRNswAEkR6HZo-KYMwmNcynhHjwa2UE1l8cjy4isr&s"
        ],
        "rating": 3.9,
        "review_count": 7,
        "additional_info": [
            "$23.99$80",
            "有现货",
            "3.9(7)",
            "满 $75 免运费",
            "30 天免费退货"
        ]
    },
...

键 (results.organic)

说明

类型

布局

pos

表示特定项在自然结果中的位置的指标。

整数

桌面与移动

url

自然结果的 URL。

字符串

桌面与移动

desc

自然结果的简短描述。

字符串

桌面与移动

title

自然结果的标题。

字符串

桌面与移动

images

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

字符串

桌面与移动

sitelinks

对象包含 `expanded` 或 `inline` 元素，提供关于 sitelinks 的更多细节。

对象

桌面与移动

sitelinks.expanded/inline

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

数组

桌面与移动

sitelinks.expanded.url

链接站点的 URL。

字符串

桌面与移动

sitelinks.expanded.title

链接站点的标题。

字符串

桌面与移动

url_shown

描述下方可见的简短 URL。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

favicon_text

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

字符串

桌面

rating

产品或内容的平均评分。

浮点数

桌面

review_count

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

整数

桌面

additional_info

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

字符串列表

桌面

自然视频

该 results.organic_videos 包含一组在搜索结果中自然展示的视频列表，表示它们不是付费广告。每个视频条目包含视频标题、URL、描述等相关详细信息。

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

键 (results.organic_videos)

说明

类型

布局

pos

表示特定项在自然视频结果中的位置的指标。

整数

桌面

url

视频的 URL。

字符串

桌面

desc

视频的简短描述。

字符串

桌面

title

视频的标题。

字符串

桌面

pos_overall

Organic 视频结果在 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": "律师",
            "source": "来自 LinkedIn",
            "employer": "Men's & Fathers' Rights Divorce Lawyers, Schultz & Associates, LLC",
            "location": "美国"
        },
                            ...
    ],
    "pos_overall": 1
},
...

键 (results.jobs)

说明

类型

布局

listings

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

数组

桌面

listings.url

完整职位列表的 URL。

字符串

桌面

listings.title

职位的标题。

字符串

桌面

listings.source

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

字符串

桌面

listings.employer

招聘该岗位的组织。

字符串

桌面

listings.location

该职位的地点。

字符串

桌面

pos_overall

Jobs SERP 功能在 SERP 中的位置指示。

整数

桌面

Twitter (X)

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

...
"twitter": {
    "pos": 1,
    "url": "https://twitter.com/NintendoAmerica",
    "items": [
        {
            "pos": 1,
            "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
            "content": "你现在可以兑换你的 #MyNintendo 白金点数 来收集节日主题的自定义图标，可用至太平洋时间 12/25 下午5点。#NintendoSwitchOnline #MissionsAndRewards\n\n了解更多：ninten.do/6017iHF1b",
            "timeframe": "12 小时前"
        },
        ...
    ],
    "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": "创始人"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Adolf Dassler"
                }
            ],
            "title": "创始人",
            "content": "Adolf Dassler"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "服装公司",
    "description": "描述Adidas AG 是一家总部位于德国巴伐利亚 Herzogenaurach 的运动服装与鞋类公司。它是欧洲最大的运动服饰制造商，也是仅次于 Nike 的世界第二大。 Wikipedia",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "人们也在搜索"
        },
        ...
    ]
},
...

键 (results.knowledge)

说明

类型

布局

title

知识面板的标题。

字符串

桌面与移动

images

紧挨标题显示的一组图片列表。

数组

桌面

factoids

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

数组

桌面与移动

factoids.links

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

数组

桌面与移动

factoids.links.href

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

字符串

桌面与移动

factoids.links.title

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

字符串

桌面与移动

factoids.title

事实信息部分的名称。

字符串

桌面与移动

factoids.content

事实信息的描述。

字符串

桌面与移动

profiles

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

字符串

桌面

profiles.url

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

字符串

桌面

profiles.title

社交媒体资料的标题。

字符串

桌面

subtitle

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

字符串

桌面与移动

description

表示知识面板中实体主要信息的描述。

字符串

桌面与移动

related_searches

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

数组

桌面

related_searches.url

Local Pack

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

Key (results.local_pack)

说明

类型

布局

条目

包含各位置及其相应详细信息的列表。

数组

桌面与移动

items.cid

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

字符串

桌面与移动

items.pos

本地结果在 Local Pack 中的位置。

整数

桌面与移动

items.title

本地实体的名称。

字符串

桌面与移动

items.rating

本地实体的评分。

整数

桌面与移动

items.address

本地实体的地址。

字符串

桌面与移动

items.rating_count

本地实体的评价数量。

整数

桌面与移动

pos_overall

指示 Local Pack 结果在 SERP 中的位置。

整数

桌面与移动

Popular Products

该 popular_products SERP 功能展示一个按热度和与用户查询相关性确定的各类产品轮播。这不同于受广告主影响的产品展示广告 (PLA)。值得注意的是，单一 SERP 页面上可能出现多个 popular_products 轮播可能出现在单个 SERP 页面上。\

...
"popular_products":[
   {
      "items":[
         {
            "pos":1,
            "price":"$109.99",
            "title":"adidas Gazelle Herren",
            "seller":"Footlocker.de",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         {
            "pos":2,
            "price":"$120.00",
            "title":"Herren adidas Gazelle Schuh",
            "rating":"4.9",
            "seller":"JD Sports Deutschland",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         ...
      ],
      "pos_overall":4
   },
   ...
]
...

Key (results.popular_products)

说明

类型

布局

条目

包含热门产品及其各自详细信息的列表。

数组

桌面与移动

items.pos

表示给定热门产品在 Popular Products SERP 功能中的位置的唯一指示符。

整数

桌面与移动

items.price

给定热门产品的价格。

字符串

桌面与移动

items.title

给定热门产品的标题。

字符串

桌面与移动

items.rating

给定热门产品的评分。

字符串

桌面

items.seller

给定热门产品的卖家。

字符串

桌面

items.image_data

商品的 base64 编码缩略图像。

字符串

桌面

pos_overall

指示 Popular Products SERP 功能在 SERP 中的整体位置。

整数

桌面与移动

该 related_searches SERP 功能显示与初始搜索关键词相关的替代搜索查询，通常位于 SERP 底部。

"related_searches": [
   {
       "pos_overall": 12,
       "related_searches": [
           "tesla model 3",
           "tesla car price", 
           "tesla model y",
           "tesla owner",
           "tesla - wikipedia", 
           "tesla cybertruck",
           "tesla 2023",
           "tesla logo"
       ]
   }
],

Key (results.related_searches)

说明

类型

布局

pos_overall

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

整数

桌面与移动

related_searches

此块内的相关搜索字符串列表。

数组

桌面与移动

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

...
"related_questions": {
    "items": [
        {
            "pos": 1,
            "answer": "According to Guinness World Records as of 1995, the Bible is the best selling book of all time with an estimated 5 billion copies sold and distributed.",
            "source": {
                "url": "https://en.wikipedia.org/wiki/List_of_best-selling_books#:~:text=According%20to%20Guinness%20World%20Records,billion%20copies%20sold%20and%20distributed.",
                "title": "List of best-selling books - Wikipedia",
                "url_shown": "Wikipediahttps://en.wikipedia.org \u203a wiki \u203a List_of_best-selling_..."
            },
            "question": "Which book is No 1 in the world?"
        },
        ...
    ],
    "pos_overall": 2
},
...

Key (results.related_questions)

说明

类型

布局

条目

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

数组

桌面与移动

items.pos

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

整数

桌面与移动

items.answer

What people are saying

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

Key (results.what_people_are_saying)

说明

类型

布局

条目

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

数组

桌面与移动

items.url

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

整数

桌面与移动

items.title

讨论线程或内容的标题。

字符串

桌面与移动

items.top_comments

如果显示，讨论线程的置顶评论。

字符串

桌面与移动

items.source

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

字符串

桌面与移动

items.engagement_timeframe

评论数和活动时间范围（例如，"45 comments, 2 days ago"）。

字符串

桌面与移动

Search Information

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

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

Key (results.search_information)

说明

类型

布局

query

原始搜索词。

字符串

桌面与移动

geo_location *

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

字符串

桌面

showing_results_for

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

字符串

桌面与移动

total_results_count

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

整数

桌面与移动

*仅适用于启用 JS 渲染时生效

Item Carousel

A carousel (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
},
...

Key (results.item_carousel)

说明

类型

布局

条目

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

数组

桌面

items.pos

项目在轮播中的位置。

整数

桌面

items.href

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

字符串

桌面

items.title

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

字符串

桌面

items.subtitle

关于标题中实体的附加详细信息。

字符串

桌面

title

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

字符串

桌面

pos_overall

指示 Item Carousel 结果在 SERP 中的位置。

整数

桌面

Recipes

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

Key (results.recipes)

说明

类型

布局

条目

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

数组

桌面与移动

items.pos

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

整数

桌面与移动

items.url

完整食谱的 URL。

字符串

桌面与移动

items.desc

从原始文章中检索到的食谱简短描述。

字符串

桌面

items.title

食谱的标题。

字符串

桌面与移动

items.rating

食谱的评分。

整数

桌面与移动

items.source

食谱所在网站的名称。

字符串

桌面与移动

items.duration

准备该菜肴所需的时间。

字符串

桌面与移动

pos_overall

指示 Recipes 结果在 SERP 中的位置。

整数

桌面与移动

Videos

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

Key (results.videos)

说明

类型

布局

条目

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

数组

桌面与移动

items.pos

视频在列表中的位置。

整数

桌面与移动

items.url

指向视频的链接。

字符串

桌面与移动

items.title

视频的标题。

字符串

桌面与移动

items.author

上传该视频的个人或频道名称。

字符串

桌面与移动

items.source

承载该视频的平台名称。

字符串

桌面与移动

pos_overall

指示 Videos 结果在 SERP 中的位置。

整数

桌面与移动

Featured Snippet

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

Key (results.featured_snippet)

说明

类型

布局

url

用于检索描述页面的摘要的网页 URL。

字符串

桌面与移动

desc

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

字符串

桌面与移动

title

检索该页面摘要的文章名称。

字符串

桌面与移动

url_shown

在 SERP 中可见的包含精选摘要的网页的 URL。

字符串

桌面与移动

pos_overall

指示 Featured Snippet 结果在 SERP 中的位置。

整数

桌面与移动

related_searches_categorized 专门展示与列表相关的搜索。与涵盖所有用户查询的一般相关搜索不同，此功能提供一组针对列表相关查询的聚焦结果。通常位于搜索结果页面底部，作为与主搜索词相关的目标关键词来源。

...
"related_searches_categorized": [
    {
        "items": [
            {
                "url": "/search?sca_esv=589812617...",
                "title": "Bayerische Motoren Werke AG"
            },
            {
                "url": "/search?safe=off&sca_esv=588766249...",
                "title": "Mercedes..."
            },
           ...
        ],
        "category": {
            "name": "Electric car companies",
            "type": "expanded"
        },
        "pos_overall": 10
    },
...

Key (results.related_searches_categorized)

说明

类型

布局

条目

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

数组

桌面

items.url

Hotels

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

Key (results.hotels)

说明

类型

布局

date_to

退房日期。

字符串

桌面

结果

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

数组

桌面

results.price

酒店的价格。

字符串

桌面

results.title

酒店的名称。

字符串

桌面

results.description

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

字符串

桌面

date_from

入住日期。

字符串

桌面

pos_overall

指示 Hotels 结果在 SERP 中的位置。

整数

桌面

Flights

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

Key (results.flights)

说明

类型

布局

to

到达机场。

字符串

桌面与移动

from

出发机场。

字符串

桌面与移动

date_to

到达的日期。

字符串

桌面与移动

结果

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

数组

桌面与移动

results.url

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

字符串

桌面与移动

results.type

航班类型。

字符串

桌面

results.price

航班的价格。

字符串

桌面与移动

results.airline

航空公司名称。

字符串

桌面与移动

results.duration

航班时长。

字符串

桌面与移动

date_from

出发日期。

字符串

桌面与移动

pos_overall

指示 Flights 结果在 SERP 中的位置。

整数

桌面与移动

Video Box

该 video_box 该功能在搜索结果页面顶部突出显示 Google 认为最相关的特定视频结果。

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

Key (results.video_box)

说明

类型

布局

url

视频的 URL。

字符串

桌面与移动

title

视频的标题。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

Local Service Ads

该 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,
            "google_guaranteed": true
        },
       ...
    ],
    "pos_overall": 2
},
...

Key (results.local_service_ads)

说明

类型

布局

条目

包含服务提供者及其各自详细信息的列表。

数组

桌面

items.pos

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

整数

桌面

items.url

指向 Local Services 搜索页面中该服务的链接。

字符串

桌面

items.title

服务提供者的名称。

字符串

桌面

items.rating

服务提供者的评分。

整数

桌面

items.reviews_count

服务提供者的评论数量。

整数

桌面

items.google_guaranteed

Google 授予通过 Google 审查和验证流程的企业的徽章。可用值为 "true" 或 "false"。

boolean

桌面

pos_overall

指示 Local Service Ads 结果在 SERP 中的位置。

整数

桌面

Apps

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

Key (results.apps)

说明

类型

布局

id

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

字符串

Mobile

url

应用商店中包含应用完整信息的 URL。

字符串

Mobile

title

应用的标题。

字符串

Mobile

rating

应用的评分。

整数

Mobile

reviews_count

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

整数

Mobile

items.reviews_count

服务提供者的评论数量。

字符串

Mobile

Finance

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

HTML 示例

Key (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 sample

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

体育比赛

关于近期体育赛事的信息，包含比分、队伍、比赛类型和亮点。

HTML 示例

键（results.sports_games）

说明

类型

布局

比赛

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

数组

桌面

games.date

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

字符串

桌面

games.teams

比赛中参与的球队

数组

桌面

games.game_type

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

字符串

桌面

games.highlight

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

字符串

桌面

games.teams.score

各队在比赛期间获得的得分或积分

字符串

桌面

games.teams.winner

指定哪支球队赢得了比赛

boolean

桌面

games.teams.team_name

显示参与比赛的球队名称

字符串

桌面

stage

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

字符串

桌面

league

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

字符串

桌面

JSON sample

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

指示“讨论和论坛”SERP 功能在搜索结果页面中的位置。

整数

桌面

JSON sample

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

最后更新于 18天前

这有帮助吗？

下午好

hashtag请求示例

hashtag请求参数值

hashtag通用

hashtagGoogle 高级搜索运算符

hashtag本地化

hashtag分页

hashtag支持连续滚动

hashtag每页限制

hashtag请求示例

hashtag过滤

hashtag其他

hashtag上下文参数

hashtag结构化数据

hashtag输出数据字典

hashtagJSON 结构

hashtag商品列表广告 (PLA)

hashtag付费

hashtag图片

hashtag自然结果

hashtag示例 1

hashtag示例 2

hashtag自然视频

hashtag热门景点

hashtag职位

hashtagTwitter (X)

hashtag知识

hashtagLocal Pack

hashtagTop Stories

hashtagPopular Products

hashtagRelated Searches

hashtagRelated Questions

hashtagWhat people are saying

hashtagSearch Information

hashtagItem Carousel

hashtagRecipes

hashtagVideos

hashtagFeatured Snippet

hashtagRelated Searches Categorized

hashtagHotels

hashtagFlights

hashtagVideo Box

hashtagLocal Service Ads

hashtagApps

hashtagFinance

hashtagHTML 示例

hashtagJSON sample

hashtag体育比赛

hashtagHTML 示例

hashtagJSON sample

hashtag讨论和论坛

hashtagHTML 示例

hashtagJSON sample

请求示例

请求参数值

通用

Google 高级搜索运算符

本地化

分页

支持连续滚动

每页限制

请求示例

过滤

其他

上下文参数

结构化数据

输出数据字典

JSON 结构

商品列表广告 (PLA)

付费

图片

自然结果

示例 1

示例 2

自然视频

热门景点

职位

Twitter (X)

知识

Local Pack

Top Stories

Popular Products

Related Searches

Related Questions

What people are saying

Search Information

Item Carousel

Recipes

Videos

Featured Snippet

Related Searches Categorized

Hotels

Flights

Video Box

Local Service Ads

Apps

Finance

HTML 示例

JSON sample

体育比赛

HTML 示例

JSON sample

讨论和论坛

HTML 示例

JSON sample