网页搜索

全面的 Google 搜索抓取器，提供解析后的数据，包含自然结果、广告、摘要、知识面板、头条新闻等。

该 google_search source 旨在检索 Google Search (SERPs) 和 Google AI Overviews 结果。本子页面专门展示与 Google Web Search 相关的信息。要查看其他结果类型，请阅读 Image Search 或 News Search.

请求示例

在下面的示例中，我们发出请求以获取 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 = {
    '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 Web 搜索结果的基本设置和自定义选项。

参数

说明

默认值

source

设置爬虫。

google_search

query

要搜索的关键字或短语。

render

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

parse

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

false

callback_url

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

user_agent_type

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

desktop

- 必需参数

Google 高级搜索运算符

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

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

本地化

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

参数

说明

默认值

geo_location

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

locale

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

context: results_language

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

分页

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

注意： 暂时，可检索的最大页面数限制为 3（30 个结果）

参数

说明

默认值

start_page

起始页码。

1

pages

要检索的页数。

1

limit

每页要检索的结果数量。

10

context:limit_per_page

使用相同 IP 地址和会话（cookie 集）抓取多页。通过在带有 page 键的 JSON 数组中指定页码，并使用 limit 键指示每页的自然结果数，您可以最大限度地减少跨页面看到重叠自然结果的机会（例如，第一页的最后一个自然结果与第二页的第一个自然结果相同）。 见示例.

支持连续滚动

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

每页限制

由于近期 Google 的限制变更，我们已调整 Web Scraper 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

待匹配或 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 键值对的对象添加到 array 和 值一起使用时可用 中，例如：

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

结构化数据

Web Scraper 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 is about more than sportswear and workout clothes. We partner with the best in the industry to co-create. This way we offer our fans the sporting goods, ...",
                            "title": "adidas Official Website | adidas US",
                            "sitelinks": {
                                "expanded": [
                                    {
                                        "url": "https://www.adidas.com/us/women",
                                        "title": "Women"
                                    },
                                    {
                                        "url": "https://www.adidas.com/us/sale",
                                        "title": "Sale"
                                    }
                                ]
                            },
                            "url_shown": "https://www.adidas.com› ...",
                            "pos_overall": 2
                        },
                        {
                            "pos": 5,
                            "url": "https://play.google.com/store/apps/details?id=com.adidas.app&hl=en_US&gl=US",
                            "desc": "YOUR ADIDAS - MORE THAN A SHOPPING APP The home of sport and sneakers, the adidas app puts you closer to the action with access to sneaker drops, ...Size: 115MUpdated: May 3, 2022 Rating: 4.8 · ‎322,391 votes · ‎Free · ‎Android · ‎Sports",
                            "title": "adidas - Apps on Google Play",
                            "url_shown": "https://play.google.com› store › apps › details › id=com....",
                            "pos_overall": 12
                        }
                    ],
                    "twitter": {
                        "pos": 1,
                        "url": "https://twitter.com/adidas",
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://twitter.com/adidas/status/1521901157064531968?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "What do you like to listen to most during workouts?",
                                "timeframe": "5 days ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "How would you describe your favorite sport to an alien?",
                                "timeframe": "Apr 27, 2022"
                            }
                        ],
                        "title": "",
                        "pos_overall": 7
                    },
                    "knowledge": {
                        "title": "Adidas",
                        "factoids": [
                            {
                                "title": "Customer service chat",
                                "content": "Online Chat"
                            },
                            {
                                "title": "Website",
                                "content": "http://www.adidas-group.com/"
                            }
                        ],
                        "profiles": [
                            {
                                "url": "https://www.instagram.com/adidas",
                                "title": "Instagram"
                            },
                            {
                                "url": "https://www.youtube.com/user/adidas",
                                "title": "YouTube"
                            }
                        ],
                        "subtitle": "Design company",
                        "description": "Adidas AG is a German multinational corporation, founded and headquartered in Herzogenaurach, Bavaria, that designs and manufactures shoes, clothing and accessories. It is the largest sportswear manufacturer in Europe, and the second largest in the world, after 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 Slides - Beige | women swim | adidas US",
                                "source": "",
                                "timeframe": "8 hours ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "Women's Clothing Sale Up to 50% Off | adidas US",
                                "source": "",
                                "timeframe": "Sep 30, 2021"
                            }
                        ],
                        "pos_overall": 3
                    },
                    "instant_answers": [
                        {
                            "type": "unknown",
                            "_parsed": false,
                            "pos_overall": 5
                        }
                    ],
                    "popular_products": {
                        "items": [
                            {
                                "pos": 1,
                                "title": "Adidas Yeezy Kids Foam Runner",
                                "image_data": "UklGRhwJAABXRUJQVlA...rAZNVIAAA"
                            },
                            {
                                "pos": 10,
                                "title": "Adidas Men's Kaptir 2.0",
                                "image_data": "UklGRhQNAAB...+wTh1cLB/uQAAAAAAAAA="
                            }
                        ],
                        "pos_overall": 4
                    },
                    "related_searches": {
                        "pos_overall": 14,
                        "related_searches": [
                            "adidas shoes",
                            "adidas yeezy",
                            "adidas outlet",
                            "adidas pants",
                            "adidas sneakers",
                            "adidas superstar",
                            "adidas wikipedia"
                        ]
                    },
                    "search_information": {
                        "query": "adidas",
                        "showing_results_for": "adidas",
                        "total_results_count": 1440000000
                    },
                    "total_results_count": 1440000000,
                    "related_searches_categorized": [
                        {
                            "category": {
                                "name": "Adidas logo",
                                "type": "collapsed"
                            },
                            "pos_overall": 13
                        }
                    ]
                },
                "last_visible_page": 10,
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 07:24:16",
            "updated_at": "2022-05-09 07:24:20",
            "page": 1,
            "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "6929330182268395521",
            "status_code": 200,
            "parser_type": "v2"
        }
    ]
}

元素的组成可能会根据它是否为 desktop 或 mobile search.

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

输出数据字典

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

HTML 示例

JSON 结构

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

特定结果类型的项目和字段数量可能取决于搜索查询而有所不同。

键名

说明

类型

url

Google 搜索页面的 URL。

string

page

相对于 Google SERP 分页的页码。

integer

results

包含搜索结果的字典。

object

results.pla

带有其各自详细信息的商品展示广告列表。

object

results.paid

带有其各自详细信息的赞助结果列表。

array

results.images

带有其各自详细信息的图片结果列表。

object

results.flights

带有其各自详细信息的航班列表。

object

results.organic

带有其各自详细信息的非付费列表（自然结果）。

array

results.organic_videos

带有其各自详细信息的自然视频列表。

array

results.top_sights

带有其各自详细信息的著名地标或景点列表。

array

results.jobs

带有其各自详细信息的职位列表。

object

results.local_service_ads

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

object

results.video_box

带有其各自详细信息的单个视频项。

object

results.recipes

带有其各自详细信息的食谱列表。

object

results.twitter

带有其各自详细信息的 Twitter (X) 结果列表。

array

results.knowledge

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

object

results.local_pack

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

object

results.item_carousel

用于信息类查询的示例项目列表及其各自详细信息。

object

results.videos

带有其各自详细信息的视频列表。

object

results.related_searches_categorized

其他人进行的相关搜索列表。

array

results.hotels

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

object

results.apps

带有其各自详细信息的应用程序列表。

array

results.finance

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

object

results.sports_games

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

object

results.discussions_and_forums

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

object

results.featured_snippet

从 SERP 自然部分检索的特定结果列表。

array

results.top_stories

当搜索查询被识别为新闻相关时的文章列表及其各自详细信息。

object

results.popular_products

Google Shopping 商品列表的非付费、有机展示及其各自详细信息。

object

results.related_searches

在搜索页面上不同位置显示的一个或多个相关搜索块的列表。

array

results.related_questions

带有其各自详细信息的相关疑问式搜索查询列表。

object

results.what_people_are_saying

带有 URL、标题、来源、置顶评论、参与度和时间范围的讨论线程和论坛帖子列表。

array

results.search_information

提交的搜索查询的详细信息列表。

object

total_results_count

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

string

last_visible_page

标识搜索结果页面中最大可见页码的值。（当通过滚动加载更多结果时为 -1）。

integer

parse_status_code

解析作业的状态代码。您可以在此处.

integer

created_at

抓取作业创建的时间戳。

timestamp

updated_at

抓取作业完成的时间戳。

timestamp

job_id

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

string

status_code

抓取作业的状态代码。您可以在此处.

integer

parser_type

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

string

在以下部分，对于某结果类型有多于一项时，解析后的 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 Newest w/Yellow & Blue controllers Wildcat Bundle(2000 V-Bucks and Code for Wildcat Bundle Included), 6.2\" Touchscreen LCD Display, 802.11",
            "seller": "Amazon.com",
            "url_image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSdvbTlG8SxMmPAm6cjeiFXvrNCIF0ZIBUUqz4B4Uww2fY7sHhaEQxbDv_JP78tu-YO3kWFbTESJPcAx5h2zezUK3bpZJnVriMGOi7Tx7nJNA8&usqp=CAc",
            "image_data": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        },
        ...
    ],
    "pos_overall": 1
},
...

键 (results.pla)

说明

类型

布局

项目

页面内所有可用的 PLA。

array

桌面和移动

items.pos

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

integer

桌面和移动

items.url

产品的 URL。

string

桌面和移动

items.price

列表广告中产品的价格。

string

桌面和移动

items.title

列表广告中产品的标题。

string

桌面和移动

items.seller

列表广告中产品的卖家。

string

桌面和移动

items.url_image

产品图片的 URL。

string

桌面

items.image_data

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

string

桌面和移动

pos_overall

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

integer

桌面和移动

Paid

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

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

键 (results.paid)

说明

类型

布局

pos

指示给定项目在付费结果中的位置的指标。

integer

桌面和移动

url

付费结果的 URL。

string

桌面和移动

desc

付费结果的简短描述。

string

桌面和移动

title

付费结果的标题。

string

桌面和移动

data_rw

付费结果的重定向 URL。

string

桌面和移动

sitelinks

包含出现在 Google 首个搜索结果下方的网站内部链接信息的对象。

object

桌面和移动

sitelinks.inline/expanded

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

array

桌面和移动

sitelinks.inline.url

链接站点的 URL。

string

桌面和移动

sitelinks.inline.title

链接站点的标题。

string

桌面和移动

sitelinks.inline.description

链接站点的简短描述。

string

桌面

url_shown

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

string

桌面和移动

pos_overall

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

integer

桌面和移动

Images

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

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

键 (results.images)

说明

类型

布局

项目

带有其各自详细信息的图片列表。

array

桌面和移动

items.alt

图片的 alt 文本。

string

桌面和移动

items.pos

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

integer

桌面和移动

items.url

包含图片的网页的 URL。

string

桌面和移动

pos_overall

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

integer

桌面和移动

Organic

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

示例 1

...
"organic": [
    {
        "pos": 1,
        "url": "https://www.loveandlemons.com/brownies-recipe/",
        "desc": "The best brownie recipe! Made with cocoa powder and chocolate chips, these homemade brownies are fudgy, gooey, super chocolaty, and easy to make!",
        "title": "Best Homemade Brownies Recipe",
        "images": [
            "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        ],
        "sitelinks": {
            "inline": [
                {
                    "url": "https://www.loveandlemons.com/recipes/vegetarian-recipes/",
                    "title": "Vegetarian Recipes"
                },
                {
                    "url": "https://www.loveandlemons.com/baking-recipes/",
                    "title": "25 Super Fun Baking Recipes"
                },
                {
                    "url": "https://www.loveandlemons.com/oatmeal-cookies/",
                    "title": "Perfect Oatmeal Cookies"
                }
            ]
        },
        "url_shown": "https://www.loveandlemons.com\u203a Recipes",
        "pos_overall": 2
    },
...

示例 2

...
"organic": [
    {
        "pos": 9,
        "pos_overall": 13,
        "title": "Classics Winter Track Jacket - Army Green",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "A soft sherpa track jacket rooted in outdoor winter sports \u00b7 Relaxed fit is loose, casual and totally unrestrictive \u00b7 Shell: 70% polyester / 30% recycled\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",
            "In stock",
            "3.9(7)",
            "Free delivery over $75",
            "Free 30-day returns"
        ]
    },
...

键 (results.organic)

说明

类型

布局

pos

指示给定项目在自然结果中的位置的指标。

integer

桌面和移动

url

自然结果的 URL。

string

桌面和移动

desc

自然结果的简短描述。

string

桌面和移动

title

自然结果的标题。

string

桌面和移动

images

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

string

桌面和移动

sitelinks

对象包含具有更多 sitelinks 详情的 `expanded` 或 `inline` 元素。

object

桌面和移动

sitelinks.expanded/inline

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

array

桌面和移动

sitelinks.expanded.url

链接站点的 URL。

string

桌面和移动

sitelinks.expanded.title

链接站点的标题。

string

桌面和移动

url_shown

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

string

桌面和移动

pos_overall

有机结果在 SERP 中的位置指示。

integer

桌面和移动

favicon_text

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

string

桌面

rating

产品或内容的平均评分。

float

桌面

review_count

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

integer

桌面

additional_info

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

字符串列表

桌面

自然视频

该 results.organic_videos 包含以自然形式显示在搜索结果中的视频列表，表示它们不是付费广告。每个视频列表包括视频标题、URL、描述等相关细节。

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

键 (results.organic_videos)

说明

类型

布局

pos

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

integer

桌面

url

视频的 URL。

string

桌面

desc

视频的简短描述。

string

桌面

title

视频的标题。

string

桌面

pos_overall

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

integer

桌面

Top Sights

该 results.top_sights 包含与搜索位置或主题通常相关的显著地标或景点列表。每个项目包括列表中的位置和标题等详细信息。

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

键 (results.top_sights)

说明

类型

布局

项目

带有其各自详细信息的顶级景点列表。

array

桌面

items.pos

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

integer

桌面

items.title

旅游景点的标题。

string

桌面

pos_overall

Top Sights 结果在 SERP 中的位置指示。

integer

桌面

Jobs

该 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

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

array

桌面

listings.url

完整职位列表的 URL。

string

桌面

listings.title

职位的标题。

string

桌面

listings.source

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

string

桌面

listings.employer

发布该职位的组织。

string

桌面

listings.location

该职位的地点。

string

桌面

pos_overall

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

integer

桌面

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

指示给定项目在自然结果中的位置的指标。

integer

桌面

url

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

string

桌面

项目

带有其各自详细信息的 Twitter (X) 帖子列表。

array

桌面

items.pos

指示给定推文在 Twitter (X) SERP 功能中的位置的指标。

string

桌面

items.url

Twitter (X) 帖子的 URL。

string

桌面

items.content

表示相关 Twitter (X) 帖子中所有文本的简短描述。

string

桌面

items.timeframe

描述推文发布距今的时间。

string

桌面

title

Twitter (X) 配置文件的标题。

string

桌面

pos_overall

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

integer

桌面

Knowledge

该 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": "DescriptionAdidas AG is a German athletic apparel and footwear corporation headquartered in Herzogenaurach, Bavaria, Germany. It is the largest sportswear manufacturer in Europe, and the second largest in the world, after Nike. Wikipedia",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "People also search for"
        },
        ...
    ]
},
...

键 (results.knowledge)

说明

类型

布局

title

知识面板的标题。

string

桌面和移动

images

紧挨标题使用的一组图片列表。

array

桌面

factoids

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

array

桌面和移动

factoids.links

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

array

桌面和移动

factoids.links.href

指向给定事实条目在 Google 搜索结果页面的超链接。

string

桌面和移动

factoids.links.title

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

string

桌面和移动

factoids.title

事实条目部分的名称。

string

桌面和移动

factoids.content

事实条目的描述。

string

桌面和移动

profiles

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

string

桌面

profiles.url

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

string

桌面

profiles.title

社交媒体资料的标题。

string

桌面

subtitle

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

string

桌面和移动

description

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

string

桌面和移动

related_searches

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

array

桌面

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)

说明

类型

布局

项目

带有各自详细信息的位置列表。

array

桌面和移动

items.cid

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

string

桌面和移动

items.pos

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

integer

桌面和移动

items.title

本地实体的标题。

string

桌面和移动

items.rating

本地实体的评分。

integer

桌面和移动

items.address

本地实体的地址。

string

桌面和移动

items.rating_count

本地实体的评论数。

integer

桌面和移动

pos_overall

指示本地包结果在 SERP 中的位置。

integer

桌面和移动

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)

说明

类型

布局

项目

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

array

桌面和移动

items.pos

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

integer

桌面和移动

items.price

给定热门产品的价格。

string

桌面和移动

items.title

给定热门产品的标题。

string

桌面和移动

items.rating

给定热门产品的评分。

string

桌面

items.seller

给定热门产品的卖家。

string

桌面

items.image_data

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

string

桌面

pos_overall

指示热门产品 SERP 功能在整个 SERP 中的大致位置。

integer

桌面和移动

该 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

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

integer

桌面和移动

related_searches

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

array

桌面和移动

该 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)

说明

类型

布局

项目

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

array

桌面和移动

items.pos

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

integer

桌面和移动

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)

说明

类型

布局

项目

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

array

桌面和移动

items.url

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

integer

桌面和移动

items.title

讨论线程或内容条目的标题。

string

桌面和移动

items.top_comments

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

string

桌面和移动

items.source

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

string

桌面和移动

items.engagement_timeframe

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

string

桌面和移动

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

原始搜索词。

string

桌面和移动

geo_location *

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

string

桌面

showing_results_for

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

string

桌面和移动

total_results_count

搜索词的结果总数。

integer

桌面和移动

*仅在启用 JS 渲染时有效

Item 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)

说明

类型

布局

项目

放入轮播中的项目列表及其各自详细信息。

array

桌面

items.pos

项目在轮播中的位置。

integer

桌面

items.href

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

string

桌面

items.title

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

string

桌面

items.subtitle

标题中实体的附加详情。

string

桌面

title

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

string

桌面

pos_overall

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

integer

桌面

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)

说明

类型

布局

项目

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

array

桌面和移动

items.pos

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

integer

桌面和移动

items.url

完整食谱的 URL。

string

桌面和移动

items.desc

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

string

桌面

items.title

食谱的标题。

string

桌面和移动

items.rating

食谱的评分。

integer

桌面和移动

items.source

食谱所在网站的名称。

string

桌面和移动

items.duration

准备该菜肴所需的时间。

string

桌面和移动

pos_overall

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

integer

桌面和移动

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)

说明

类型

布局

项目

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

array

桌面和移动

items.pos

视频在列表中的位置。

integer

桌面和移动

items.url

指向视频的链接。

string

桌面和移动

items.title

视频的标题。

string

桌面和移动

items.author

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

string

桌面和移动

items.source

托管该视频的平台名称。

string

桌面和移动

pos_overall

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

integer

桌面和移动

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。

string

桌面和移动

desc

包含特定搜索结果描述的片段。

string

桌面和移动

title

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

string

桌面和移动

url_shown

在 SERP 中可见的包含精选摘录的网站 URL。

string

桌面和移动

pos_overall

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

integer

桌面和移动

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 中水平轮播检索到的所有相关搜索项的列表。

array

桌面

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

退房日期。

string

桌面

results

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

array

桌面

results.price

酒店的价格。

string

桌面

results.title

酒店的名称。

string

桌面

results.description

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

string

桌面

date_from

入住日期。

string

桌面

pos_overall

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

integer

桌面

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

到达机场。

string

桌面和移动

from

出发机场。

string

桌面和移动

date_to

到达日期。

string

桌面和移动

results

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

array

桌面和移动

results.url

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

string

桌面和移动

results.type

航班类型。

string

桌面

results.price

航班价格。

string

桌面和移动

results.airline

承运人名称。

string

桌面和移动

results.duration

航班时长。

string

桌面和移动

date_from

出发日期。

string

桌面和移动

pos_overall

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

integer

桌面和移动

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。

string

桌面和移动

title

视频的标题。

string

桌面和移动

pos_overall

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

integer

桌面和移动

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)

说明

类型

布局

项目

具有各自详细信息的服务提供商列表。

array

桌面

items.pos

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

integer

桌面

items.url

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

string

桌面

items.title

服务提供商的标题。

string

桌面

items.rating

服务提供商的评分。

integer

桌面

items.reviews_count

服务提供商的评论数。

integer

桌面

items.google_guaranteed

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

boolean

桌面

pos_overall

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

integer

桌面

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。

string

Mobile

url

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

string

Mobile

title

应用的标题。

string

Mobile

rating

应用的评分。

integer

Mobile

reviews_count

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

integer

Mobile

items.reviews_count

服务提供商的评论数。

string

Mobile

Finance

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

HTML 示例

Key (results.finance)

说明

类型

布局

low

指定日期的最低价。

float

桌面

date

报告净资产值的日期。

string

桌面

high

指定日期的最高价

float

桌面

open

指定日期的开盘价

float

桌面

source

相关 Google Finance 源网站的 URL。

string

桌面

difference

最近报告的净资产值与其前一次报告值之间的变化。

string

桌面

market_cap

公司已发行股票的总市值（以美元计）。

string

桌面

stock_name

股票名称。

string

桌面

52_week_low

52 周最低价。

float

桌面

52_week_high

52 周最高价。

float

桌面

current_price

实时价格报价。

string

桌面

dividend_yield

每股股息与每股价格之比（股息收益率）。

float

桌面

price_earning_ratio

股票的市盈率。

float

桌面

JSON 示例

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

体育比赛

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

HTML 示例

键（results.sports_games）

说明

类型

布局

比赛

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

array

桌面

games.date

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

string

桌面

games.teams

比赛中参赛的队伍

array

桌面

games.game_type

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

string

桌面

games.highlight

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

string

桌面

games.teams.score

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

string

桌面

games.teams.winner

指明哪支队伍赢得了比赛

boolean

桌面

games.teams.team_name

显示比赛中参赛队伍的名称

string

桌面

stage

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

string

桌面

league

指负责该赛事的体育联盟或组织

string

桌面

JSON 示例

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

讨论与论坛

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

HTML 示例

键（results.discussions_and_forums）

说明

类型

布局

项目

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

array

桌面

items.pos

表示给定条目在所有“讨论与论坛”结果中的位置的指示器。

integer

桌面

items.url

特定论坛帖子或讨论线程的 URL 链接

string

桌面

items.title

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

string

桌面

items.source

承载论坛或讨论的来源

string

桌面

items.timeframe

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

string

桌面

items.comments_count

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

string

桌面

pos_overall

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

integer

桌面

JSON 示例

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

最后更新于2小时前

这有帮助吗？

下午好

hashtag请求示例

hashtag请求参数值

hashtag通用

hashtagGoogle 高级搜索运算符

hashtag本地化

hashtag分页

hashtag支持连续滚动

hashtag每页限制

hashtag请求示例

hashtag过滤

hashtag其他

hashtag上下文参数

hashtag结构化数据

hashtag输出数据字典

hashtagJSON 结构

hashtag商品展示广告 (PLA)

hashtagPaid

hashtagImages

hashtagOrganic

hashtag示例 1

hashtag示例 2

hashtag自然视频

hashtagTop Sights

hashtagJobs

hashtagTwitter (X)

hashtagKnowledge

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

hashtag体育比赛

hashtagHTML 示例

hashtagJSON 示例

hashtag讨论与论坛

hashtagHTML 示例

hashtagJSON 示例

请求示例

请求参数值

通用

Google 高级搜索运算符

本地化

分页

支持连续滚动

每页限制

请求示例

过滤

其他

上下文参数

结构化数据

输出数据字典

JSON 结构

商品展示广告 (PLA)

Paid

Images

Organic

示例 1

示例 2

自然视频

Top Sights

Jobs

Twitter (X)

Knowledge

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

体育比赛

HTML 示例

JSON 示例

讨论与论坛

HTML 示例

JSON 示例