网页搜索

全面的 Google 搜索抓取器，带已解析的数据，涵盖自然结果、广告、摘要、知识面板、头条新闻等。

该 google_search 该 source 旨在检索 Google 搜索（SERP）和 Google AI Overviews 结果。本子页面专门展示与 Google Web 搜索相关的信息。若要探索其他结果类型，请阅读 图像搜索 或 新闻搜索.

请求示例

在下面的示例中，我们发出请求以获取 2 结果页面，从编号 11 到编号 12 ，针对搜索词 adidas 在 google.nl 域。SERP 将被过滤以仅包含法语结果。API 将返回解析后的结果。

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "domain": "nl",
        "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',
    'domain': 'nl',
    '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,
)

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

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_search",
    domain: "nl",
    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',
    'domain' => 'nl',
    '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",
		"domain":     "nl",
		"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",
                domain = "nl",
                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("domain", "nl");
        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",
    "domain": "nl",
    "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 参数结构此处.

domain

Google 的域名本地化。完整可用域名列表可在此处找到此处.

com

locale

Accept-Language 更改您 Google 搜索页面网页界面语言的 header 值。 更多信息.

context: results_language

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

分页

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

参数

说明

默认值

start_page

起始页码。

1

pages

要检索的页面数量。

1

limit

每页要检索的结果数量。

10

context:limit_per_page

使用相同 IP 地址和会话（cookie 集）抓取多页。通过在 JSON 数组中使用 page 键并使用 limit 键指示每页的有机结果数，您可以将跨页出现重复有机结果（例如第一页的最后一个有机结果与第二页的第一个有机结果相同）的概率降到最低。 参见示例.

支持连续滚动

网页爬虫 API 完全支持 Google Search 的连续滚动。它会自动检测连续滚动布局，在无需额外参数的情况下高效加载请求的有机结果。

每页限制

由于 Google 最近的限制更改，我们调整了网页爬虫API 的行为。每页最大结果将与 Google 的有机输出匹配，通常为 10 个结果。

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

参数

说明

示例

page

您要抓取的页面编号。任何大于 0 的整数值都可用

1

limit

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

90

请求示例

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

筛选

用于根据各种条件过滤和细化搜索结果的选项。了解如何使用上下文参数此处.

参数

说明

默认值

context: 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 value app）。更多信息此处.

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

其他

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

参数

说明

默认值

context: fpstate

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

context: nfpr

true 将关闭拼写自动更正

false

上下文参数

所有上下文参数应作为对象添加到 context 数组，包含 key 和 value 键值对，例如：

...
"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 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 搜索而有所不同。

为帮助您识别某些元素，请参阅针对每种类型的 Google 搜索结果（无论是桌面还是移动搜索）提供的数据字典。

输出数据字典

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

HTML 示例

JSON 结构

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

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

键名称

说明

类型

url

Google 搜索页面的 URL。

字符串

page

相对于 Google SERP 分页的页码。

整数

results

包含搜索结果的字典。

对象

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

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

数组

results.top_stories

当查询被识别为新闻相关时，包含文章及其相应详情的列表。

对象

results.popular_products

Google Shopping 产品列表的非付费、有机展示及其相应详情的列表。

对象

results.related_searches

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

数组

results.related_questions

包含相关询问性搜索查询及其相应详情的列表。

对象

results.what_people_are_saying

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

数组

results.search_information

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

对象

total_results_count

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

字符串

last_visible_page

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

整数

parse_status_code

解析作业的状态码。您可以在此处查看解析器状态码说明此处.

整数

created_at

抓取作业创建的时间戳。

timestamp

updated_at

抓取作业完成的时间戳。

timestamp

job_id

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

字符串

status_code

抓取作业的状态码。您可以在此处查看爬虫状态码说明此处.

整数

parser_type

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

字符串

在下列部分，当结果类型存在多个项时，解析后的 JSON 代码片段会被缩短。

商品列表广告（PLA）

该 pla 搜索结果部分指商品列表广告（也称为 Google Shopping Ads），以轮播格式显著显示在搜索页面顶部。

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

说明

类型

布局

items

页面内所有可用的 PLA。

数组

桌面与移动

items.pos

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

整数

桌面与移动

items.url

产品的 URL。

字符串

桌面与移动

items.price

列表广告中产品的价格。

字符串

桌面与移动

items.title

列表广告中产品的标题。

字符串

桌面与移动

items.seller

列表广告中产品的卖家。

字符串

桌面与移动

items.url_image

产品图片的 URL。

字符串

桌面

items.image_data

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

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

付费

该 paid 本节指由 Google Ads 推动的广告，通常出现在自然（非付费）结果之上。

... 
"paid": [
    {
        "pos": 1,
        "url": "https://www.adidas.com/us/cyber_monday",
        "desc": "最后机会抢网络优惠。使用代码 CYBERSALE 全场促销及正价商品额外 45% 折扣。今天就到 adidas\u00ae 官方网站购物。加入我们的 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\u00ae 鞋款"
                },
                {
                    "url": "https://www.adidas.com/us/ultraboost",
                    "desc": "令人难以置信的能量回馈，立即选购全新 Ultraboost\u2122 Light.",
                    "title": "adidas\u00ae Ultraboost\u2122 Light"
                },
                {
                    "url": "https://www.adidas.com/us/nmd",
                    "desc": "线上选购 adidas Originals 的最新 NMD 系列鞋款。",
                    "title": "adidas\u00ae 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 | 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)

说明

类型

布局

items

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

数组

桌面与移动

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": "最棒的布朗尼食谱！使用可可粉和巧克力豆制作，这些自制布朗尼湿润、黏稠、浓郁巧克力风味且简单易做！",
        "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 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": "一件以户外冬季运动为根基的柔软羊羔绒运动夹克 \u00b7 宽松版型，轻松随性且完全不受束缚 \u00b7 面料：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",
            "In stock",
            "3.9(7)",
            "Free delivery over $75",
            "Free 30-day returns"
        ]
    },
...

键 (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

产品或内容的平均评分。

float

桌面

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 Video 结果在 SERP 中的位置指示器。

整数

桌面

招聘信息

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

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

键 (results.jobs)

说明

类型

布局

listings

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

数组

桌面

listings.url

完整职位列表的 URL。

字符串

桌面

listings.title

职位的标题。

字符串

桌面

listings.source

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

字符串

桌面

listings.employer

发布该职位的组织或雇主。

字符串

桌面

listings.location

职位的工作地点。

字符串

桌面

pos_overall

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

整数

桌面

Twitter (X)

该 twitter 该功能常为品牌、电影、音乐人和其他名人显示，通常放置在品牌网站搜索结果下方。此功能提供指向品牌 Twitter 订阅页的直接链接，展示其最新推文的走马灯样式预览。

...
"twitter": {
    "pos": 1,
    "url": "https://twitter.com/NintendoAmerica",
    "items": [
        {
            "pos": 1,
            "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
            "content": "You can now redeem your #MyNintendo Platinum Points to collect holiday themed custom icons, available until 12/25 at 5pm PT. #NintendoSwitchOnline #MissionsAndRewards\n\nLearn more: ninten.do/6017iHF1b",
            "timeframe": "12 hours ago"
        },
        ...
    ],
    "title": "Nintendo of America (@NintendoAmerica) \u00b7 X",
    "pos_overall": 4
},
...

键 (results.twitter)

说明

类型

布局

pos

表示该项目在自然结果中的位置指示器。

整数

桌面

url

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

字符串

桌面

items

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

数组

桌面

items.pos

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

字符串

桌面

items.url

Twitter (X) 帖子的 URL。

字符串

桌面

items.content

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

字符串

桌面

items.timeframe

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

字符串

桌面

title

Twitter (X) 资料的标题。

字符串

桌面

pos_overall

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

整数

桌面

知识

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

...
"knowledge": {
    "title": "Adidas",
    "images": [
        "iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..."
    ],
    "factoids": [
        {
            "links": [
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Founder"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Adolf Dassler"
                }
            ],
            "title": "Founder",
            "content": "Adolf Dassler"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "Apparel company",
    "description": "说明 Adidas AG 是一家总部位于德国巴伐利亚 Herzogenaurach 的德国运动服饰与鞋类公司。它是欧洲最大的运动服制造商，也是仅次于耐克的全球第二大制造商。维基百科",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "People also search for"
        },
        ...
    ]
},
...

键 (results.knowledge)

说明

类型

布局

title

知识面板的标题。

字符串

桌面与移动

images

标题旁边使用的一组图片列表。

数组

桌面

factoids

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

数组

桌面与移动

factoids.links

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

数组

桌面与移动

factoids.links.href

指向该 factoid 的 Google 搜索结果页面的超链接。

字符串

桌面与移动

factoids.links.title

与该 factoid 相关的任何链接页面的描述。

字符串

桌面与移动

factoids.title

factoid 部分的名称。

字符串

桌面与移动

factoids.content

factoid 的描述。

字符串

桌面与移动

profiles

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

字符串

桌面

profiles.url

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

字符串

桌面

profiles.title

社交媒体资料的标题。

字符串

桌面

subtitle

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

字符串

桌面与移动

description

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

字符串

桌面与移动

related_searches

带有各自详细信息的相关搜索列表。

数组

桌面

related_searches.url

本地列表

该 local_pack 显示基于用户位置或指定搜索位置的前三名本地搜索结果，包括地图和其他信息。

...
"local_pack": {
                        "items": [
                            {
                                "cid": "1100080596967423812",
                                "pos": 1,	
                                "title": "Pizza Hut",
                                "rating": 3.8,
                                "address": "Independence, KS",
                                "subtitle": "Pizza",
                                "rating_count": 435
                            },
                            ...
                        ],
                        "pos_overall": 1
                    },
...

键 (results.local_pack)

说明

类型

布局

items

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

数组

桌面与移动

items.cid

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

字符串

桌面与移动

items.pos

本地结果在 local pack 中的位置。

整数

桌面与移动

items.title

本地实体的标题。

字符串

桌面与移动

items.rating

本地实体的评分。

整数

桌面与移动

items.address

本地实体的地址。

字符串

桌面与移动

items.rating_count

本地实体的评分数量。

整数

桌面与移动

pos_overall

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

整数

桌面与移动

头条新闻

top_stories 是针对新闻类查询在 Google 搜索中出现的专门部分。

...
"top_stories": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.independent.co.uk/arts-entertainment/films/news/elon-musk-leave-the-world-behind-b2462401.html",
            "title": "Netflix users mock 'triggered' Elon Musk over Leave the World Behind \ncomplaint11 hours ago",
            "source": "The Independent",
            "timeframe": "11 hours ago"
        },
        ...
    ],
    "pos_overall": 3
},
...

键 (results.top_stories)

说明

类型

布局

items

所选新闻文章的列表及其各自详细信息。

数组

桌面与移动

items.pos

文章在 Top Stories SERP 功能中的位置。

整数

桌面与移动

items.url

完整文章的 URL。

字符串

桌面与移动

items.title

文章的标题。

字符串

桌面与移动

items.section

人们怎么说

该 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": "欢迎来到旧金山！有几点说明。\n* 十月通常是一年中我们天气最好的时候。好计划！(提醒其他读者：旧金山的“夏天”通常非常多雾且很冷。)\n* (这可能非常明显，提前道歉。也许对其他读者有帮助。) 49 人队实际上不在旧金山附近比赛。若无交通，市中心到 Levi's 的车程约一小时。使用公共交通（或配合 Uber/Lyft）大约需 90-120 分钟。\n* 我建议住在旧金山市区本身。如果你不想住在旧金山，靠近 BART 的地方可以让你用较少费用观光。\n* 在旧金山，注意 Tenderloin 区是一个较艰难的社区。那是你在 Fox News 中常看到的“失控的旧金山”故事出现的地方。城市的其他部分相对安全且比较干净。\n* 旧金山西侧，尤其是 Sunset 区，公共交通连接较少。你完全可以不用车四处活动，但去市中心或到铁路系统会花更长时间。\n恭喜退休！听起来是个不错的奖励。",
                                "source": "Reddit",
                                "engagement_timeframe": "10+ comments, 1 week ago"
                            },
                            {
                                "pos": 2,
                                "url": "https://www.tiktok.com/@kaorihatsusee/video/7501124173717065006",
                                "title": "Honestly enjoyed our stay here 🫶🏼 @maya hangai 📍Kasa La Monarca, San Francisco #affordable #affordablehotel #hotel #sanfrancisco"
                                "source": "TikTok",
                                "engagement_timeframe": "45.3K+views, 3 weeks ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco",
                                "title": "23 Best Hotels in San Francisco, From Mission Bay to the Castro District"
                                "source": "Condé Nast Traveller",
                                "engagement_timeframe": "1 month ago"
                            }
                        ]
                    }
...

键 (results.what_people_are_saying)

说明

类型

布局

items

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

数组

桌面与移动

items.url

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

整数

桌面与移动

items.title

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

字符串

桌面与移动

items.top_comments

讨论线程中显示的热门评论（若有）。

字符串

桌面与移动

items.source

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

字符串

桌面与移动

items.engagement_timeframe

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

字符串

桌面与移动

搜索信息

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

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

键 (results.search_information)

说明

类型

布局

query

原始搜索词。

字符串

桌面与移动

geo_location *仅适用于 JS 渲染

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

字符串

桌面

showing_results_for

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

字符串

桌面与移动

total_results_count

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

整数

桌面与移动

项目走马灯

一个走马灯（item_carousel）将在 SERP 顶部显示与特定类型项目相关的图片或链接。内容和布局依据用户的搜索查询而有所不同，展示一组相关项目，范围可涵盖产品、新闻或图片，提供视觉化且针对性的用户体验。

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

键 (results.item_carousel)

说明

类型

布局

items

放在走马灯中的项目列表及其各自详细信息。

数组

桌面

items.pos

项目在走马灯中的位置。

整数

桌面

items.href

指向走马灯中项目的 Google SERP 的超链接。

字符串

桌面

items.title

走马灯中实体的名称/标题。

字符串

桌面

items.subtitle

标题中实体的附加详情。

字符串

桌面

title

走马灯部分的标题。标题与搜索查询相关。

字符串

桌面

pos_overall

指示项目轮播结果在搜索引擎结果页（SERP）中的位置。

整数

桌面

食谱

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

...
"recipes": {
    "items": [
        {
            "pos": 1,
            "url": "https://handletheheat.com/chewy-brownies/",
            "desc": "无糖可可粉、巧克力碎片、小苏打、蛋黄、通用面粉",
            "title": "史上最好吃的嚼劲布朗尼",
            "rating": 4.8,
            "source": "Handle the Heat",
            "duration": "45 分钟"
        },
...
    ],
    "pos_overall": 1
},
...

键 (results.recipes)

说明

类型

布局

items

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

数组

桌面与移动

items.pos

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

整数

桌面与移动

items.url

完整食谱的 URL。

字符串

桌面与移动

items.desc

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

字符串

桌面

items.title

食谱的标题。

字符串

桌面与移动

items.rating

食谱的评分。

整数

桌面与移动

items.source

该食谱所在网站的名称。

字符串

桌面与移动

items.duration

准备菜肴所需的时间。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

视频

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

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

键 (results.videos)

说明

类型

布局

items

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

数组

桌面与移动

items.pos

视频在列表中的位置。

整数

桌面与移动

items.url

指向视频的链接。

字符串

桌面与移动

items.title

视频的标题。

字符串

桌面与移动

items.author

上传该视频的账号名称。

字符串

桌面与移动

items.source

承载该视频的平台名称。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

特色摘要

该 featured_snippet 是一种独特的 Google 搜索结果，先展示一段简洁的页面描述片段，然后是指向该页面的链接。这些高亮结果在自然搜索结果顶部显著显示，为用户提供快速获取相关信息的途径。

...
"featured_snippet": [
    {
        "url": "https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors",
        "desc": "随着秋季夜晚变长，叶绿素的生成逐渐减慢直至停止，最终所有叶绿素被破坏。叶片中存在的类胡萝卜素和花青素随后被显现出来并显示出它们的颜色。",
        "title": "秋色科学 | 美国林务局",
        "url_shown": "https://www.fs.usda.gov\u203a visit \u203a science-of-fall-colors",
        "pos_overall": 1
    }
],
...

键 (results.featured_snippet)

说明

类型

布局

url

检索出描述页面片段的网站的 URL。

字符串

桌面与移动

desc

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

字符串

桌面与移动

title

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

字符串

桌面与移动

url_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": "电动汽车公司",
            "type": "expanded"
        },
        "pos_overall": 10
    },
...

键 (results.related_searches_categorized)

说明

类型

布局

items

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

数组

桌面

items.url

酒店

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

...
"hotels": {
    "date_to": "周一, 12 月 11 日",
    "results": [
        {
            "price": "£54",
            "title": "Hilton Garden Inn Vilnius City Centre",
            "description": "带餐厅/酒吧的现代酒店"
        },
        {
            "price": "£57",
            "title": "Radisson Blu Hotel Lietuva",
            "description": "带水疗和餐饮的现代高层酒店"
        },
       ...
    ],
    "date_from": "周日, 12 月 10 日",
    "pos_overall": 5
},
...

键 (results.hotels)

说明

类型

布局

date_to

退房日期。

字符串

桌面

results

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

数组

桌面

results.price

酒店的价格。

字符串

桌面

results.title

酒店的名称。

字符串

桌面

results.description

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

字符串

桌面

date_from

入住日期。

字符串

桌面

pos_overall

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

整数

桌面

航班

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

...
"flights": {
    "to": "伦敦，英国（所有机场）",
    "from": "纽约，NY（所有机场）",
    "date_to": "周一, 1 月 29 日",
    "results": [
        {
            "url": "https://www.google.com/travel/flights?safe=off&sca_esv=590053957&source=flun&uitype=cuAA&hl=en&gl=us&curr=USD&tfs=CAEQAhotEgoyMDI0LTAxLTIyMgJaMGoNCAISCS9tLzAyXzI4NnIMCAISCC9tLzA0anBsGi0SCjIwMjQtMDEtMjkyAlowagwIAhIIL20vMDRqcGxyDQgCEgkvbS8wMl8yODZ6aENqUklUVmxrYjA1V2RubE9kazFCUkRSM2RrRkNSeTB0TFMwdExTMHRMWGxzWm5FeU9FRkJRVUZCUjFZMFNrMXpTVXhTTTJ0QkVnTnVXakFhQ3dpOHlnSVFBaG9EVlZORU9EQnd2TW9D",
            "type": "直达",
            "price": "$423",
            "airline": "Norse Atlantic UK",
            "duration": "6 小时 50 分钟"
        },
       ...
    ],
    "date_from": "周一, 1 月 22 日",
    "pos_overall": 1
},
...

键 (results.flights)

说明

类型

布局

to

到达的机场。

字符串

桌面与移动

from

出发的机场。

字符串

桌面与移动

date_to

到达的日期。

字符串

桌面与移动

results

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

数组

桌面与移动

results.url

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

字符串

桌面与移动

results.type

航班的类型。

字符串

桌面

results.price

航班的价格。

字符串

桌面与移动

results.airline

承运人的名称。

字符串

桌面与移动

results.duration

航班时长。

字符串

桌面与移动

date_from

出发日期。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

视频框

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

键 (results.video_box)

说明

类型

布局

url

视频的 URL。

字符串

桌面与移动

title

视频的标题。

字符串

桌面与移动

pos_overall

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

整数

桌面与移动

本地服务广告

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

键 (results.local_service_ads)

说明

类型

布局

items

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

数组

桌面

items.pos

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

整数

桌面

items.url

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

字符串

桌面

items.title

服务提供者的标题。

字符串

桌面

items.rating

服务提供者的评分。

整数

桌面

items.reviews_count

服务提供者的评论数量。

整数

桌面

items.google_guaranteed

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

布尔

桌面

pos_overall

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

整数

桌面

应用

该 apps SERP 功能根据用户查询展示相关应用，提供价格、评分等关键信息。该功能为应用开发者和发行商提供了在 Google 搜索结果页上提升移动应用可见性和参与度的渠道。

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

键 (results.apps)

说明

类型

布局

id

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

字符串

移动端

url

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

字符串

移动端

title

应用的标题。

字符串

移动端

rating

应用的评分。

整数

移动端

reviews_count

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

整数

移动端

items.reviews_count

服务提供者的评论数量。

字符串

移动端

财经

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

HTML 示例

键 (results.finance)

说明

类型

布局

最低

指定日期的最低价格。

float

桌面

日期

报告净资产价值的日期。

字符串

桌面

最高

指定日期的最高价格

float

桌面

开盘

指定日期的开盘价

float

桌面

source

相关 Google Finance 来源网站的 URL。

字符串

桌面

差额

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

字符串

桌面

市值

公司已发行股票的总美元价值

字符串

桌面

股票名称

股票的名称。

字符串

桌面

52 周最低

52 周最低价格

float

桌面

52 周最高

52 周最高价格

float

桌面

当前价格

实时价格报价。

字符串

桌面

股息收益率

每股股息与每股价格的比率（股息÷股价）

float

桌面

市盈率

股票的市盈率

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)

说明

类型

布局

比赛

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

数组

桌面

games.date

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

字符串

桌面

games.teams

比赛中涉及的队伍

数组

桌面

games.game_type

比赛的类型，例如常规赛、季后赛、决赛等。

字符串

桌面

games.highlight

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

字符串

桌面

games.teams.score

各队在比赛中获得的得分或分数

字符串

桌面

games.teams.winner

指明哪支队伍赢得了比赛

布尔

桌面

games.teams.team_name

显示比赛中队伍的名称

字符串

桌面

阶段

体育比赛或锦标赛的特定阶段或环节。

字符串

桌面

联赛

指监管该赛事的体育联赛或组织

字符串

桌面

JSON 示例

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

讨论与论坛

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

HTML 示例

键 (results.discussions_and_forums)

说明

类型

布局

items

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

数组

桌面

items.pos

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

整数

桌面

items.url

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

字符串

桌面

items.title

论坛帖或讨论主题的标题

字符串

桌面

items.source

承载该论坛或讨论的来源

字符串

桌面

items.timeframe

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

字符串

桌面

items.comments_count

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

字符串

桌面

pos_overall

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

整数

桌面

JSON 示例

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

最后更新于1个月前

这有帮助吗？

晚安

请求示例

请求参数值

通用

Google 高级搜索运算符

本地化

分页

支持连续滚动

每页限制

请求示例

筛选

其他

上下文参数

结构化数据

输出数据字典

JSON 结构

商品列表广告（PLA）

付费

图片

自然

示例 1

示例 2

自然视频

热门景点

招聘信息

Twitter (X)

知识

本地列表

头条新闻

热门商品

相关搜索

相关问题

人们怎么说

搜索信息

项目走马灯

食谱

视频

特色摘要

分类的相关搜索

酒店

航班

视频框

本地服务广告

应用

财经

HTML 示例

JSON 示例

体育比赛

HTML 示例

JSON 示例

讨论与论坛

HTML 示例

JSON 示例