网页搜索

全面的 Google 搜索抓取器，提供已解析的有机结果、广告、摘要、知识面板、要闻等数据。

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

请求示例

在下面的示例中，我们发出请求以获取 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。
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,
)

# 将美化后的响应打印到 stdout。
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 网页搜索结果的基本设置和自定义选项。

参数

描述

默认值

source

设置抓取器。

google_search

query

要搜索的关键字或短语。

render

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

parse

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

false

callback_url

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

user_agent_type

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

desktop

- 必填参数

Google 高级搜索操作符

在抓取时，结合 Google 高级搜索操作符可能会很有用。它使您能够自定义搜索范围，确保结果更相关、更聚焦。探索这些特殊命令 here 和 here。下面给出示例。

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

本地化

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

参数

描述

默认值

geo_location

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

domain

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

com

locale

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

results_language: 结果语言。受支持的 Google 语言列表可在此处找到

。了解如何使用 context 参数 here分页 here.

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

start_page

参数

描述

默认值

起始页码。

pages

1

要检索的页数。

limit

1

每页要检索的结果数量。

limit_per_page

10

results_language:使用相同的 IP 地址和会话（cookie 集）抓取多页。通过在包含

page 键的 JSON 数组中指定页码，并使用 键指明每页的自然结果数量，可以将跨页出现重叠自然结果的可能性降到最低（例如第一页的最后一个自然结果与第二页的第一个自然结果相同）。 每页要检索的结果数量。 参见示例 支持连续滚动.

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

每页限制

由于 Google 最近的限制更改，我们已调整 Web Scraper API 的行为。每页的最大结果数将与 Google 的自然输出相匹配，通常为 10 个结果。

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

示例

参数

描述

您想抓取的页码。任何大于

键的 JSON 数组中指定页码，并使用

的整数值均可 0 将有效

1

每页要检索的结果数量。

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

90

请求示例

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

过滤

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

参数

描述

默认值

results_language: filter

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

1

results_language: safe_search

安全搜索。设置为 true 以启用它。

false

results_language: udm

udm 该参数允许在不同的搜索选项卡之间切换，例如图片、地点或视频，以自定义显示的结果类型。查找接受的值 here.

results_language: tbm

要匹配或 tbm 参数。接受的值为： app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

results_language: tbs

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

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

其他

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

参数

描述

默认值

results_language: fpstate

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

results_language: nfpr

true 将关闭拼写自动更正

false

上下文参数

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

...
"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 不只是运动服装和训练服。我们与业界最佳合作，共同创造。通过这种方式，我们为粉丝提供运动用品，...",
                            "title": "adidas 官方网站 | 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": "在锻炼时你最喜欢听什么？",
                                "timeframe": "5 天前"
                            },
                            {
                                "pos": 3,
                                "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
                                "content": "你会如何向外星人描述你最喜欢的运动？",
                                "timeframe": "2022 年 4 月 27 日"
                            }
                        ],
                        "title": "",
                        "pos_overall": 7
                    },
                    "knowledge": {
                        "title": "Adidas",
                        "factoids": [
                            {
                                "title": "客户服务聊天",
                                "content": "在线聊天"
                            },
                            {
                                "title": "网站",
                                "content": "http://www.adidas-group.com/"
                            }
                        ],
                        "profiles": [
                            {
                                "url": "https://www.instagram.com/adidas",
                                "title": "Instagram"
                            },
                            {
                                "url": "https://www.youtube.com/user/adidas",
                                "title": "YouTube"
                            }
                        ],
                        "subtitle": "设计公司",
                        "description": "Adidas AG 是一家总部位于巴伐利亚 Herzogenaurach 的德国跨国公司，设计并制造鞋类、服装和配饰。它是欧洲最大的运动服装制造商，世界第二，仅次于 Nike。",
                        "related_searches": [
                            {
                                "url": "/search?gl=us&hl=en&q=Nike&si=AC1wQDCwN61-ebmuwbQCO5QCrgOvEq5bkWeIzJ5JczItzAKNdbIxoHfFJ8UFY3e1CorwNJXI6gTWniM6aVu3nEoseblyAI-5N39_1F3DTWWABELjIdJa9ZgI_g5n-c9ZUZdzEZeV2VGOkDNPl5DwiBeyifKPveoCnBsiT3wVpKdr52FPqK5rzQSzspA-sjztjVcZy2WfOwFITo5EfSXyZ5AsknO1X-dzXUCOlIIGCvFWqi9OKgK5PaWp7EcXls7n8Ag_L7HC3Pgg2k5FWR631X7Hvi1268shAg%3D%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAU",
                                "title": "Nike"
                            },
                            {
                                "url": "/search?gl=us&hl=en&q=Asics&si=AC1wQDDagiMg03ncxeOQZbwVe-CJxRCchC-jr2hCPTxjc9wbgNZ1pCnWqLo_0N5RPhArBCY1qCgzESLe6Y9hB2HKnzquQNjJW9iLV6gQvDXzTwkl6LZHjq2aOuZII0W5uCWjpc0oOVU5JzyOjRUNEYoe_N_KsbL4xn4A0Fl2S4JMYAeaBZmu8jPX8EFVl_C3gerS4CRTyrfcL2bL-VhUNLEXVUlkFxrLlAyeZfUMVYSDo4WqV1c8-Bgp-rBwBzqW73Q7s1kOZHBtCQ8aBNfbfulPCljSG9vXBrcj9RqQRA8pD8TlH1rz8qE%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAs",
                                "title": "Asics"
                            }
                        ]
                    },
                    "top_stories": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.adidas.com/us/adilette-comfort-slides/GZ5898.html",
                                "title": "adidas Adilette Comfort 拖鞋 - 米色 | 女士泳装 | adidas 美国",
                                "source": "",
                                "timeframe": "8 小时前"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.adidas.com/us/women-clothing-sale",
                                "title": "女士服装促销 高达 50% 折扣 | adidas 美国",
                                "source": "",
                                "timeframe": "2021 年 9 月 30 日"
                            }
                        ],
                        "pos_overall": 3
                    },
                    "instant_answers": [
                        {
                            "type": "unknown",
                            "_parsed": false,
                            "pos_overall": 5
                        }
                    ],
                    "popular_products": {
                        "items": [
                            {
                                "pos": 1,
                                "title": "Adidas Yeezy 儿童 Foam Runner",
                                "image_data": "UklGRhwJAABXRUJQVlA...rAZNVIAAA"
                            },
                            {
                                "pos": 10,
                                "title": "Adidas 男款 Kaptir 2.0",
                                "image_data": "UklGRhQNAAB...+wTh1cLB/uQAAAAAAAAA="
                            }
                        ],
                        "pos_overall": 4
                    },
                    "related_searches": {
                        "pos_overall": 14,
                        "related_searches": [
                            "adidas shoes",
                            "adidas yeezy",
                            "adidas outlet",
                            "adidas pants",
                            "adidas sneakers",
                            "adidas superstar",
                            "adidas wikipedia"
                        ]
                    },
                    "search_information": {
                        "query": "adidas",
                        "showing_results_for": "adidas",
                        "total_results_count": 1440000000
                    },
                    "total_results_count": 1440000000,
                    "related_searches_categorized": [
                        {
                            "category": {
                                "name": "Adidas 徽标",
                                "type": "collapsed"
                            },
                            "pos_overall": 13
                        }
                    ]
                },
                "last_visible_page": 10,
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 07:24:16",
            "updated_at": "2022-05-09 07:24:20",
            "page": 1,
            "url": "https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "6929330182268395521",
            "status_code": 200,
            "parser_type": "v2"
        }
    ]
}

元素的组成可能会根据其是否为 desktop 或 移动端 搜索。

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

输出数据字典

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

HTML 示例

JSON 结构

Google 网页搜索结构化输出包含诸如 URL, 键的 JSON 数组中指定页码，并使用, 结果, 等等。下表列出了我们解析的每个 SERP 功能的详细清单，以及其描述和数据类型。表中还包含一些元数据。

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

键名称

描述

类型

url

Google 搜索页面的 URL。

字符串

键的 JSON 数组中指定页码，并使用

相对于 Google SERP 分页的页码。

整数

结果

包含搜索结果的字典。

对象

results.pla

具有各自详细信息的产品列表广告的列表。

对象

results.paid

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

数组

results.images

具有各自详细信息的图像结果列表。

对象

results.flights

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

对象

results.organic

具有各自详细信息的非付费列表。

数组

results.organic_videos

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

数组

results.top_sights

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

数组

results.jobs

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

对象

results.local_service_ads

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

对象

results.video_box

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

对象

results.recipes

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

对象

results.twitter

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

数组

results.knowledge

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

对象

results.local_pack

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

对象

results.item_carousel

针对信息型查询的示例性项目列表及其各自详细信息。

对象

results.videos

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

对象

results.related_searches_categorized

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

数组

results.hotels

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

对象

results.apps

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

数组

results.finance

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

对象

results.sports_games

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

对象

results.discussions_and_forums

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

对象

results.featured_snippet

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

数组

results.top_stories

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

对象

results.popular_products

具有各自详细信息的 Google 购物产品列表的非付费、有机展示列表。

对象

results.related_searches

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

数组

results.related_questions

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

对象

results.what_people_are_saying

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

数组

results.search_information

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

对象

total_results_count

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

字符串

last_visible_page

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

整数

parse_status_code

解析任务的状态代码。您可以在此处查看解析器状态代码说明 here.

整数

created_at

抓取任务创建的时间戳。

timestamp

updated_at

抓取任务完成的时间戳。

timestamp

job_id

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

字符串

status_code

抓取任务的状态代码。您可以在此处查看爬虫状态代码说明 here.

整数

parser_type

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

字符串

在以下部分，当该结果类型存在多于一项时，解析后的 JSON 代码片段将被缩短。

产品列表广告 (PLA)

该 pla 搜索结果部分指产品列表广告，也称为 Google 购物广告，以旋转木马形式突出显示在搜索页面顶部。

...
"pla": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.amazon.com/Switch-Controllers-Wildcat-Touchscreen-Bluetooth/dp/B09N4S9TWV?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A1GYW88KAZG2FO",
            "price": "$675.49",
            "title": "Switch PURTCH 最新版，配黄色和蓝色手柄 Wildcat 套装（含 2000 V-Bucks 和 Wildcat 套装兑换码），6.2\" 触摸屏 LCD 显示屏，802.11",
            "seller": "Amazon.com",
            "url_image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSdvbTlG8SxMmPAm6cjeiFXvrNCIF0ZIBUUqz4B4Uww2fY7sHhaEQxbDv_JP78tu-YO3kWFbTESJPcAx5h2zezUK3bpZJnVriMGOi7Tx7nJNA8&usqp=CAc",
            "image_data": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        },
        ...
    ],
    "pos_overall": 1
},
...

键 (results.pla)

描述

类型

布局

项目

页面中可用的所有 PLA。

数组

桌面和移动端

items.pos

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

整数

桌面和移动端

items.url

产品的 URL。

字符串

桌面和移动端

items.price

列表广告中产品的价格。

字符串

桌面和移动端

items.title

列表广告中产品的标题。

字符串

桌面和移动端

items.seller

列表广告中产品的销售方。

字符串

桌面和移动端

items.url_image

产品图片的 URL。

字符串

桌面

items.image_data

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

字符串

桌面和移动端

pos_overall

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

整数

桌面和移动端

付费

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

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

键 (results.paid)

描述

类型

布局

pos

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

整数

桌面和移动端

url

付费结果的 URL。

字符串

桌面和移动端

desc

付费结果的简短描述。

字符串

桌面和移动端

title

付费结果的标题。

字符串

桌面和移动端

data_rw

付费结果的重定向 URL。

字符串

桌面和移动端

sitelinks

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

对象

桌面和移动端

sitelinks.inline/expanded

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

数组

桌面和移动端

sitelinks.inline.url

所链接站点的 URL。

字符串

桌面和移动端

sitelinks.inline.title

所链接站点的标题。

字符串

桌面和移动端

sitelinks.inline.description

所链接站点的简短描述。

字符串

桌面

url_shown

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

字符串

桌面和移动端

pos_overall

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

整数

桌面和移动端

图像

该 images 该部分指在 SERP 页面以不同部分显示的图像结果，无论是作为专用部分还是位于顶部。需要注意的是，从 Google 搜索结果抓取的数据结构可能与 Google 图片搜索结果抓取的数据结构不同。

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

键 (results.images)

描述

类型

布局

项目

具有其各自详细信息的图像列表。

数组

桌面和移动端

items.alt

图像的替代文本（alt 文本）。

字符串

桌面和移动端

items.pos

表示图像在列表中位置的唯一指标。

整数

桌面和移动端

items.url

包含该图像的网页的 URL。

字符串

桌面和移动端

pos_overall

表示图像 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 - 迷彩绿",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "一款基于户外冬季运动的柔软羊羔绒运动夹克 · 宽松版型，休闲且完全不受束缚 · 面料：70% 涤纶 / 30% 回收...",
        "favicon_text": "Reebok",
        "images": [
            "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS7NvhUuvYcmAxmRNswAEkR6HZo-KYMwmNcynhHjwa2UE1l8cjy4isr&s"
        ],
        "rating": 3.9,
        "review_count": 7,
        "additional_info": [
            "$23.99$80",
            "有现货",
            "3.9(7)",
            "满 $75 免费送货",
            "30 天免费退货"
        ]
    },
...

键 (results.organic)

描述

类型

布局

pos

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

整数

桌面和移动端

url

自然结果的 URL。

字符串

桌面和移动端

desc

自然结果的简短描述。

字符串

桌面和移动端

title

自然结果的标题。

字符串

桌面和移动端

images

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

字符串

桌面和移动端

sitelinks

对象包含 `expanded` 或 `inline` 元素，提供有关 sitelinks 的更多详细信息。

对象

桌面和移动端

sitelinks.expanded/inline

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

数组

桌面和移动端

sitelinks.expanded.url

所链接站点的 URL。

字符串

桌面和移动端

sitelinks.expanded.title

所链接站点的标题。

字符串

桌面和移动端

url_shown

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

字符串

桌面和移动端

pos_overall

表示自然结果在 SERP 中位置的指标。

整数

桌面和移动端

favicon_text

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

字符串

桌面

rating

产品或内容的平均评分。

浮点数

桌面

review_count

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

整数

桌面

additional_info

包含有关定价、库存、产品评分、配送选项、退货政策的详细信息。

字符串列表

桌面

自然视频

该 results.organic_videos 包含一组在搜索结果中自然显示（非付费）的影片列表。每个视频项包含视频标题、URL、描述等相关详细信息。

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

键 (results.organic_videos)

描述

类型

布局

pos

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

整数

桌面

url

视频的 URL。

字符串

桌面

desc

视频的简短描述。

字符串

桌面

title

视频的标题。

字符串

桌面

pos_overall

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

整数

桌面

职位

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

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

键 (results.jobs)

描述

类型

布局

listings

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

数组

桌面

listings.url

指向完整职位列表的 URL。

字符串

桌面

listings.title

职位的名称。

字符串

桌面

listings.source

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

字符串

桌面

listings.employer

发布该职位的组织。

字符串

桌面

listings.location

职位的地点。

字符串

桌面

pos_overall

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

整数

桌面

Twitter (X)

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

...
"twitter": {
    "pos": 1,
    "url": "https://twitter.com/NintendoAmerica",
    "items": [
        {
            "pos": 1,
            "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
            "content": "您现在可以兑换 #MyNintendo 铂金积分，以收集节日主题的自定义图标，可用至 12/25 太平洋时间 17:00。#NintendoSwitchOnline #MissionsAndRewards\n\n了解更多：ninten.do/6017iHF1b",
            "timeframe": "12 小时前"
        },
        ...
    ],
    "title": "Nintendo of America (@NintendoAmerica) · X",
    "pos_overall": 4
},
...

键 (results.twitter)

描述

类型

布局

pos

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

整数

桌面

url

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

字符串

桌面

项目

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

数组

桌面

items.pos

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

字符串

桌面

items.url

Twitter (X) 帖子的 URL。

字符串

桌面

items.content

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

字符串

桌面

items.timeframe

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

字符串

桌面

title

Twitter (X) 资料的标题。

字符串

桌面

pos_overall

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

整数

桌面

知识面板

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

...
"knowledge": {
    "title": "Adidas",
    "images": [
        "iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..."
    ],
    "factoids": [
        {
            "links": [
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "创始人"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Adolf Dassler"
                }
            ],
            "title": "创始人",
            "content": "Adolf Dassler"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "服装公司",
    "description": "描述Adidas AG 是一家总部位于德国巴伐利亚州赫尔佐格瑙拉赫的德国运动服装和鞋类公司。它是欧洲最大的运动服饰制造商，全球第二，仅次于 Nike。维基百科",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "人们也搜索"
        },
        ...
    ]
},
...

键 (results.knowledge)

描述

类型

布局

title

知识面板的标题。

字符串

桌面和移动端

images

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

数组

桌面

事实要点

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

数组

桌面和移动端

factoids.links

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

数组

桌面和移动端

factoids.links.href

指向该事实要点的 Google 搜索结果页面的超链接。

字符串

桌面和移动端

factoids.links.title

与事实要点相关的任何链接页面的描述。

字符串

桌面和移动端

factoids.title

事实要点部分的名称。

字符串

桌面和移动端

factoids.content

事实要点的描述。

字符串

桌面和移动端

个人资料

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

字符串

桌面

profiles.url

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

字符串

桌面

profiles.title

社交媒体资料的标题。

字符串

桌面

副标题

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

字符串

桌面和移动端

描述

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

字符串

桌面和移动端

相关搜索

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

数组

桌面

related_searches.url

本地包

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

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

键 (results.local_pack)

描述

类型

布局

项目

包含各自详情的位置列表。

数组

桌面和移动端

items.cid

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

字符串

桌面和移动端

items.pos

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

整数

桌面和移动端

items.title

本地实体的标题。

字符串

桌面和移动端

items.rating

本地实体的评分。

整数

桌面和移动端

items.address

本地实体的地址。

字符串

桌面和移动端

items.rating_count

本地实体的评分数量。

整数

桌面和移动端

pos_overall

表示本地包结果在搜索结果页面中的位置。

整数

桌面和移动端

头条新闻

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 用户嘲讽对《Leave the World Behind》\n感到“被触发”的 Elon Musk 投诉 11 小时前",
            "source": "The Independent",
            "timeframe": "11 小时前"
        },
        ...
    ],
    "pos_overall": 3
},
...

键 (results.top_stories)

描述

类型

布局

项目

带有各自详细信息的精选新闻文章列表。

数组

桌面和移动端

items.pos

文章在头条新闻 SERP 功能中的位置。

整数

桌面和移动端

items.url

完整文章的 URL。

字符串

桌面和移动端

items.title

文章的标题。

字符串

桌面和移动端

items.section

头条新闻部分的名称。

字符串

移动端

items.source

发布文章的网站名称。

字符串

桌面和移动端

items.timeframe

描述文章发布时间距今多久。

字符串

桌面

pos_overall

指示头条新闻 SERP 功能在搜索结果页中的总体位置。

整数

桌面和移动端

人们在说什么

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

...
"what_people_are_saying": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.reddit.com/r/travel/comments/1kxf875/san_francisco_hotels/",
                                "title": "旧金山酒店",
                                "top_comments": "欢迎来到旧金山！几点提示。\n* 十月通常是一年中我们最好的天气。计划很好！（顺便说一句：在旧金山，所谓的\"夏天\"通常非常多雾且寒冷。）\n*（这可能非常显而易见，提前道歉。也许对其他读者有帮助。）49 人队并不真的在旧金山附近比赛。无交通时，从旧金山市区开车到 Levi's 大约一小时。公共交通（可能配合 Uber/Lyft）约需 90-120 分钟。\n* 我建议住在旧金山市内。如果你不想住在旧金山，靠近 BART 的地方可以让你在不花太多钱的情况下观光。\n* 在旧金山内，要注意泰德洛恩（Tenderloin）是个治安很差的社区。那是你经常在福克斯新闻看到的“失控的旧金山”报道里的地方。城市的其他地方相对安全且较为干净。\n* 旧金山的西侧，尤其是日落区（Sunset），公共交通连接较差。你完全可以在没有汽车的情况下出行，但到市中心或火车系统会花更长时间。\n祝贺你的退休！听起来是不错的奖励。",
                                "source": "Reddit",
                                "engagement_timeframe": "10+ 条评论，1 周前"
                            },
                            {
                                "pos": 2,
                                "url": "https://www.tiktok.com/@kaorihatsusee/video/7501124173717065006",
                                "title": "真的很喜欢我们的入住 🫶🏼 @maya hangai 📍Kasa La Monarca, San Francisco #affordable #affordablehotel #hotel #sanfrancisco"
                                "source": "TikTok",
                                "engagement_timeframe": "45.3K+ 次观看，3 周前"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco",
                                "title": "旧金山 23 家最佳酒店，从 Mission Bay 到 Castro 区"
                                "source": "Condé Nast Traveller",
                                "engagement_timeframe": "1 个月前"
                            }
                        ]
                    }
...

键 (results.what_people_are_saying)

描述

类型

布局

项目

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

数组

桌面和移动端

items.url

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

整数

桌面和移动端

items.title

讨论线程或内容的标题。

字符串

桌面和移动端

items.top_comments

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

字符串

桌面和移动端

items.source

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

字符串

桌面和移动端

items.engagement_timeframe

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

字符串

桌面和移动端

搜索信息

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

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

键 (results.search_information)

描述

类型

布局

query

原始搜索词。

字符串

桌面和移动端

geo_location *仅与 JS 渲染配合使用

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

字符串

桌面

showing_results_for

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

字符串

桌面和移动端

total_results_count

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

整数

桌面和移动端

项目轮播

一个轮播 (item_carousel)，在 SERP 顶部显示与特定类型项目相关的图像或链接。内容和布局根据用户搜索查询而异，展示一系列相关项目，范围可以从产品和新闻到图片，为用户创造视觉化且定制化的体验。

...
"item_carousel": {
    "items": [
        {
            "pos": 1,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "哈利法塔 828\u00a0m，顶端 830\u00a0m",
            "subtitle": "828m，顶端 830m"
        },
        {
            "pos": 2,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Warisan Merdeka Tower 679\u00a0m",
            "subtitle": "679m"
        },
...
     ],
    "title": "建筑（按高度）",
    "pos_overall": 1
},
...

键 (results.item_carousel)

描述

类型

布局

项目

轮播中项目及其各自详情的列表。

数组

桌面

items.pos

项目在轮播中的位置。

整数

桌面

items.href

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

字符串

桌面

items.title

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

字符串

桌面

items.subtitle

标题中实体的附加细节。

字符串

桌面

title

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

字符串

桌面

pos_overall

表示项目轮播结果在搜索结果页中的位置。

整数

桌面

食谱

该 recipes 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.pos

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

整数

桌面和移动端

items.url

完整食谱的 URL。

字符串

桌面和移动端

items.desc

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

字符串

桌面

items.title

食谱的标题。

字符串

桌面和移动端

items.rating

食谱的评分。

整数

桌面和移动端

items.source

食谱所在网站的名称。

字符串

桌面和移动端

items.duration

准备该菜所需的时间。

字符串

桌面和移动端

pos_overall

表示食谱结果在搜索结果页中的位置。

整数

桌面和移动端

视频

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

...
"videos": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.youtube.com/watch?v=xFrGuyw1V8s",
            "title": "Abba - Dancing Queen (官方翻新版音乐视频)",
            "author": "AbbaVEVO",
            "source": "YouTube"
        },
        {
            "pos": 2,
            "url": "https://www.youtube.com/watch?v=-crgQGdpZR0",
            "title": "ABBA - Take A Chance On Me (官方音乐视频)",
            "author": "AbbaVEVO",
            "source": "YouTube"
        },
...
    ],
    "pos_overall": 4
},
...

键 (results.videos)

描述

类型

布局

项目

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

数组

桌面和移动端

items.pos

视频在列表中的位置。

整数

桌面和移动端

items.url

视频的链接。

字符串

桌面和移动端

items.title

视频的标题。

字符串

桌面和移动端

items.author

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

字符串

桌面和移动端

items.source

托管视频的平台名称。

字符串

桌面和移动端

pos_overall

表示视频结果在搜索结果页中的位置。

整数

桌面和移动端

精选摘要

该 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

在搜索结果中可见的包含精选摘要的网站 URL。

字符串

桌面和移动端

pos_overall

表示精选摘要结果在搜索结果页中的位置。

整数

桌面和移动端

分类相关搜索

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

...
"related_searches_categorized": [
    {
        "items": [
            {
                "url": "/search?sca_esv=589812617...",
                "title": "巴伐利亚发动机制造股份公司"
            },
            {
                "url": "/search?safe=off&sca_esv=588766249...",
                "title": "梅赛德斯..."
            },
           ...
        ],
        "category": {
            "name": "电动汽车公司",
            "type": "expanded"
        },
        "pos_overall": 10
    },
...

键 (results.related_searches_categorized)

描述

类型

布局

项目

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

数组

桌面

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

酒店的价格。

字符串

桌面

results.title

酒店的名称。

字符串

桌面

results.description

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

字符串

桌面

date_from

入住日期。

字符串

桌面

pos_overall

表示酒店结果在搜索结果页中的位置。

整数

桌面

航班

该 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.url

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

字符串

桌面和移动端

results.type

航班类型。

字符串

桌面

results.price

航班价格。

字符串

桌面和移动端

results.airline

航空公司的名称。

字符串

桌面和移动端

results.duration

航班的时长。

字符串

桌面和移动端

date_from

出发日期。

字符串

桌面和移动端

pos_overall

表示航班结果在搜索结果页中的位置。

整数

桌面和移动端

视频框

该 video_box 该功能在搜索结果页顶部突出显示由 Google 选为与查询最相关的特定视频结果。

...
"video_box": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (官方音乐视频)",
    "pos_overall": 1
},
...

键 (results.video_box)

描述

类型

布局

url

视频的 URL。

字符串

桌面和移动端

title

视频的标题。

字符串

桌面和移动端

pos_overall

表示视频框结果在搜索结果页中的位置。

整数

桌面和移动端

本地服务广告

该 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.pos

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

整数

桌面

items.url

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

字符串

桌面

items.title

服务提供商的标题。

字符串

桌面

items.rating

服务提供商的评分。

整数

桌面

items.reviews_count

服务提供商的评论数量。

整数

桌面

items.google_guaranteed

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

布尔值

桌面

pos_overall

表示本地服务广告结果在搜索结果页中的位置。

整数

桌面

应用

该 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

包含完整应用信息的应用商店页面的 URL（在 SERP 中）。

字符串

移动端

title

应用的标题。

字符串

移动端

rating

应用的评分。

整数

移动端

reviews_count

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

整数

移动端

items.reviews_count

服务提供商的评论数量。

字符串

移动端

财经

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

HTML 示例

键 (results.finance)

描述

类型

布局

最低价

指定日期的最低价格。

浮点数

桌面

日期

报告净值时的日期。

字符串

桌面

最高价

指定日期的最高价格

浮点数

桌面

开盘价

指定日期的开盘价

浮点数

桌面

source

相关 Google Finance 来源网站的 URL。

字符串

桌面

差额

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

字符串

桌面

市值

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

字符串

桌面

股票名称

股票的名称。

字符串

桌面

52 周最低

52 周最低价

浮点数

桌面

52_week_high

52 周最高价

浮点数

桌面

current_price

实时价格报价。

字符串

桌面

dividend_yield

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

浮点数

桌面

price_earning_ratio

该股票的市盈率

浮点数

桌面

JSON 示例

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

体育比赛

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

HTML 示例

键 (results.sports_games)

描述

类型

布局

games

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

数组

桌面

games.date

比赛预定进行或发生的日期和时间

字符串

桌面

games.teams

比赛中参赛的队伍

数组

桌面

games.game_type

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

字符串

桌面

games.highlight

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

字符串

桌面

games.teams.score

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

字符串

桌面

games.teams.winner

指定哪支队伍赢得了比赛

布尔值

桌面

games.teams.team_name

显示参赛队伍的名称

字符串

桌面

stage

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

字符串

桌面

league

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

字符串

桌面

JSON 示例

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

讨论与论坛

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

HTML 示例

键 (results.discussions_and_forums)

描述

类型

布局

项目

Google 索引的论坛或讨论线程内的条目数组

数组

桌面

items.pos

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

整数

桌面

items.url

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

字符串

桌面

items.title

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

字符串

桌面

items.source

承载该论坛或讨论的来源

字符串

桌面

items.timeframe

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

字符串

桌面

items.comments_count

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

字符串

桌面

pos_overall

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

整数

桌面

JSON 示例

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

最后更新于8天前

这有帮助吗？

下午好

hashtag请求示例

hashtag请求参数值

hashtag通用

hashtagGoogle 高级搜索操作符

hashtag本地化

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

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

hashtag由于 Google 最近的限制更改，我们已调整 Web Scraper API 的行为。每页的最大结果数将与 Google 的自然输出相匹配，通常为 10 个结果。

hashtag请求示例

hashtag过滤

hashtag其他

hashtag上下文参数

hashtag结构化数据

hashtag输出数据字典

hashtagJSON 结构

hashtag产品列表广告 (PLA)

hashtag付费

hashtag图像

hashtag自然结果

hashtag示例 1

hashtag示例 2

hashtag自然视频

hashtag热门景点

hashtag职位

hashtagTwitter (X)

hashtag知识面板

hashtag本地包

hashtag头条新闻

hashtag热门商品

hashtag相关搜索

hashtag相关问题

hashtag人们在说什么

hashtag搜索信息

hashtag项目轮播

hashtag食谱

hashtag视频

hashtag精选摘要

hashtag分类相关搜索

hashtag酒店

hashtag航班

hashtag视频框

hashtag本地服务广告

hashtag应用

hashtag财经

hashtagHTML 示例

hashtagJSON 示例

hashtag体育比赛

hashtagHTML 示例

hashtagJSON 示例

hashtag讨论与论坛

hashtagHTML 示例

hashtagJSON 示例

请求示例

请求参数值

通用

Google 高级搜索操作符

本地化

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

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

由于 Google 最近的限制更改，我们已调整 Web Scraper API 的行为。每页的最大结果数将与 Google 的自然输出相匹配，通常为 10 个结果。

请求示例

过滤

其他

上下文参数

结构化数据

输出数据字典

JSON 结构

产品列表广告 (PLA)

付费

图像

自然结果

示例 1

示例 2

自然视频

热门景点

职位

Twitter (X)

知识面板

本地包

头条新闻

热门商品

相关搜索

相关问题

人们在说什么

搜索信息

项目轮播

食谱

视频

精选摘要

分类相关搜索

酒店

航班

视频框

本地服务广告

应用

财经

HTML 示例

JSON 示例

体育比赛

HTML 示例

JSON 示例

讨论与论坛

HTML 示例

JSON 示例