网页搜索

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

The google_search source is designed to retrieve Google Search (SERPs) and Google AI Overviews results. This sub-page specifically presents information related to Google Web Search. To explore other result types, read Image Search or News Search.

Request samples

In the samples below, we make a request to get 2 results pages, from number 11 to number 12 , for search term adidas. The SERP will be filtered to contain French-language results only. API will return parsed results.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "adidas",
        "start_page": 11,
        "pages": 2,
        "parse": true,
        "context": [
            {
                "key": "results_language",
                "value": "fr"
            }
        ]
    }'

import requests
from pprint import pprint


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


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

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_search",
    query: "adidas",
    start_page: 11,
    pages: 2,
    parse: true,
    context: [
        { key: "results_language", value: "fr" },
    ],
};

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

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

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

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

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

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

<?php

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

$ch = curl_init();

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


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

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

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

package main

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

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

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

	jsonValue, _ := json.Marshal(payload)

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

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

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

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

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

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

            var client = new HttpClient();

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

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

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

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

            Console.WriteLine(contents);
        }
    }
}

package org.example;

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

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

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

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

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

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

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

        System.exit(0);
    }

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

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

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Google Web search results.

Parameter

Description

Default Value

source

Sets the scraper.

google_search

query

The keyword or phrase to search for.

render

Enables JavaScript rendering when set to html. More info.

parse

Returns parsed data when set to true. Explore output data dictionary.

false

callback_url

URL to your callback endpoint. More info.

user_agent_type

Device type and browser. The full list can be found here.

desktop

- mandatory parameter

Google Advanced Search Operators

When scraping, you might find it useful to combine Google advanced search operators with your query. It enables you to customize the scope of the search, ensuring that the results are more relevant and focused. Explore these special commands here and here. See an example below.

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

Localization

Adapt search results to specific geographical locations, locales, and languages.

Parameter

Description

Default Value

geo_location

The geographical location that the result should be adapted for. Using this parameter correctly is extremely important to get the right data. For more information, read about our suggested geo_location parameter structures here.

locale

Accept-Language header value which changes your Google search page web interface language. More info.

context: results_language

Results language. List of supported Google languages can be found here. Learn how to use context parameters here.

Pagination

Controls for managing the pagination and retrieval of search results.

Note: Temporarily, the maximum number of retrievable pages is limited to 5 (50 results)

Parameter

Description

Default Value

start_page

Starting page number.

1

pages

Number of pages to retrieve.

1

limit

Number of results to retrieve in each page.

10

context:limit_per_page

Scrape multiple pages using the same IP address and session (cookie set). By specifying the page numbers in a JSON array with the page key and indicating the number of organic results per page using the limit key, you can minimize the chance of seeing overlapping organic results across pages (e.g., the last organic result on the first page being the same as the first organic result on the second page). See example.

Continuous scroll support

Web Scraper API fully supports Google Search continuous scroll. It automatically detects continuous scrolling layouts, efficiently loading the requested organic results without any extra parameters required.

Limit per page

Due to recent Google limit changes, we've adjusted Web Scraper API's behavior. Maximum results per page will match Google's organic output, which is typically 10 results.

To use this feature, include a JSON array with JSON objects containing the following data:

Parameter

Description

Example

page

The number of the page you would like to scrape. Any integer value greater than 0 will work

1

limit

The number of results on the page in question. Any integer value between 1 and 100 (inclusive) will work.

90

Request sample

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

Filtering

Options to filter and refine search results based on various criteria. Learn how to use context parameters here.

Parameter

Description

Default Value

context: filter

Setting the value of this parameter to 0 lets you see results that would otherwise be excluded due to similarity to other results.

1

context: safe_search

Safe search. Set to true to enable it.

false

context: udm

udm parameter allows switching between different search tabs, such as images, places, or videos, to customize the type of results displayed. Find the accepted values here.

context: tbm

To-be-matched or tbm parameter. Accepted values are: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

context: tbs

This parameter is like a container for more obscure google parameters, like limiting/sorting results by date as well as other filters some of which depend on the tbm parameter (e.g. tbs=app_os:1 is only available with tbm value app). More info here.

udm and tbm context parameters cannot be used together in a single scraping request; please select only one. Using both simultaneously may lead to conflicts or unexpected behavior.

Other

Additional advanced settings and controls for specialized requirements.

Parameter

Description

Default Value

context: fpstate

Setting the fpstate value to aig will make Google load more apps. This parameter is only useful if used together with the render parameter.

context: nfpr

true will turn off spelling auto-correction

false

Context parameters

All context parameters should be added to the context array as objects with key and value pairs, e.g.:

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

Structured data

Web Scraper API is capable of extracting either an HTML or JSON object that contains Google search results, offering structured data on various elements of the results page.

google_search structured output

{
    "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 or 移动搜索。

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

输出数据字典

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

HTML 示例

JSON 结构

Google Web Search 的结构化输出包括类似以下字段 URL, page, 结果，以及其他字段。下表列出了我们解析的每种 SERP 功能的详细清单、描述和数据类型。表中还包含一些元数据。

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

键名

Description

类型

url

Google 搜索页面的 URL。

字符串

page

相对于 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

从有机 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

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

整数

created_at

抓取任务创建的时间戳。

timestamp

updated_at

抓取任务完成的时间戳。

timestamp

job_id

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

字符串

status_code

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

整数

parser_type

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

字符串

在以下部分，当某种结果类型可用多于一项时，解析后的 JSON 代码片段会被缩短。

Product Listing Ads (PLA)

The pla 搜索结果部分指产品列表广告，也称为 Google Shopping 广告，通常以轮播格式显著显示在搜索页面顶部。

...
"pla": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.amazon.com/Switch-Controllers-Wildcat-Touchscreen-Bluetooth/dp/B09N4S9TWV?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A1GYW88KAZG2FO",
            "price": "$675.49",
            "title": "Switch PURTCH Newest w/Yellow & Blue controllers Wildcat Bundle(2000 V-Bucks and Code for Wildcat Bundle Included), 6.2\" Touchscreen LCD Display, 802.11",
            "seller": "Amazon.com",
            "url_image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSdvbTlG8SxMmPAm6cjeiFXvrNCIF0ZIBUUqz4B4Uww2fY7sHhaEQxbDv_JP78tu-YO3kWFbTESJPcAx5h2zezUK3bpZJnVriMGOi7Tx7nJNA8&usqp=CAc",
            "image_data": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        },
        ...
    ],
    "pos_overall": 1
},
...

键（results.pla）

Description

类型

布局

项目

页面内所有可用的 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

The paid 该部分指由 Google Ads 推动的广告，通常出现在有机（非付费）结果之上。

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

键（results.paid）

Description

类型

布局

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

The 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）

Description

类型

布局

项目

具有各自详细信息的图片清单。

数组

桌面和移动

items.alt

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

字符串

桌面和移动

items.pos

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

整数

桌面和移动

items.url

包含该图片的网页的 URL。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

Organic

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

示例 1

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

示例 2

...
"organic": [
    {
        "pos": 9,
        "pos_overall": 13,
        "title": "Classics Winter Track Jacket - Army Green",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "A soft sherpa track jacket rooted in outdoor winter sports \u00b7 Relaxed fit is loose, casual and totally unrestrictive \u00b7 Shell: 70% polyester / 30% recycled\u00a0...",
        "favicon_text": "Reebok",
        "images": [
            "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS7NvhUuvYcmAxmRNswAEkR6HZo-KYMwmNcynhHjwa2UE1l8cjy4isr&s"
        ],
        "rating": 3.9,
        "review_count": 7,
        "additional_info": [
            "$23.99$80",
            "In stock",
            "3.9(7)",
            "Free delivery over $75",
            "Free 30-day returns"
        ]
    },
...

键（results.organic）

Description

类型

布局

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

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

字符串列表

桌面

Organic Videos

The results.organic_videos 包含在搜索结果中以有机方式显示的视频列表，即非付费广告。每个视频列出相关详细信息，例如视频标题、URL、描述等。

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

键（results.organic_videos）

Description

类型

布局

pos

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

整数

桌面

url

视频的 URL。

字符串

桌面

desc

视频的简短描述。

字符串

桌面

title

视频的标题。

字符串

桌面

pos_overall

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

整数

桌面

Top Sights

The results.top_sights 包含与搜索位置或主题通常相关的著名地标或景点清单。每个项目包括位置和标题等详细信息。

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

键（results.top_sights）

Description

类型

布局

项目

具有各自详细信息的顶级景点清单。

数组

桌面

items.pos

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

整数

桌面

items.title

旅游景点的标题。

字符串

桌面

pos_overall

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

整数

桌面

Jobs

The 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）

Description

类型

布局

listings

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

数组

桌面

listings.url

完整职位列表的 URL。

字符串

桌面

listings.title

职位的标题。

字符串

桌面

listings.source

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

字符串

桌面

listings.employer

发布该职位的组织。

字符串

桌面

listings.location

职位的地点。

字符串

桌面

pos_overall

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

整数

桌面

Twitter (X)

The 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）

Description

类型

布局

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

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

...
"knowledge": {
    "title": "Adidas",
    "images": [
        "iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..."
    ],
    "factoids": [
        {
            "links": [
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Founder"
                },
                {
                    "href": "/search?safe=off&sca_esv=586315320...",
                    "title": "Adolf Dassler"
                }
            ],
            "title": "Founder",
            "content": "Adolf Dassler"
        },
        ...
    ],
    "profiles": [
        {
            "url": "https://www.instagram.com/adidas",
            "title": "Instagram"
        },
        ...
    ],
    "subtitle": "Apparel company",
    "description": "DescriptionAdidas AG is a German athletic apparel and footwear corporation headquartered in Herzogenaurach, Bavaria, Germany. It is the largest sportswear manufacturer in Europe, and the second largest in the world, after Nike. Wikipedia",
    "related_searches": [
        {
            "url": "/search?safe=off&sca_esv=586315320...",
            "title": "Nike",
            "section_title": "People also search for"
        },
        ...
    ]
},
...

键（results.knowledge）

Description

类型

布局

title

知识面板的标题。

字符串

桌面和移动

images

紧挨标题使用的一组图片清单。

数组

桌面

factoids

知识面板中使用的所有事实的清单。

数组

桌面和移动

factoids.links

与给定信息条目相关的所有链接列表。

数组

桌面和移动

factoids.links.href

指向该信息在 Google 搜索结果页面的超链接。

字符串

桌面和移动

factoids.links.title

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

字符串

桌面和移动

factoids.title

信息部分的名称。

字符串

桌面和移动

factoids.content

该信息的描述。

字符串

桌面和移动

profiles

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

字符串

桌面

profiles.url

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

字符串

桌面

profiles.title

社交媒体资料的标题。

字符串

桌面

subtitle

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

字符串

桌面和移动

description

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

字符串

桌面和移动

related_searches

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

数组

桌面

related_searches.url

Local Pack

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

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

Key (results.local_pack)

Description

类型

布局

项目

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

数组

桌面和移动

items.cid

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

字符串

桌面和移动

items.pos

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

整数

桌面和移动

items.title

本地区实体的标题。

字符串

桌面和移动

items.rating

本地区实体的评分。

整数

桌面和移动

items.address

本地区实体的地址。

字符串

桌面和移动

items.rating_count

本地区实体的评分数量。

整数

桌面和移动

pos_overall

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

整数

桌面和移动

Popular Products

The popular_products SERP 功能显示一个基于产品受欢迎程度和与用户查询相关性的产品轮播。这不同于受广告商影响的产品列表广告（PLA）。值得注意的是，单个 SERP 页面上可能出现多个 popular_products 轮播可能出现在单个 SERP 页面上。\

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

Key (results.popular_products)

Description

类型

布局

项目

带有各自详细信息的热门产品列表。

数组

桌面和移动

items.pos

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

整数

桌面和移动

items.price

给定热门产品的价格。

字符串

桌面和移动

items.title

给定热门产品的标题。

字符串

桌面和移动

items.rating

给定热门产品的评分。

字符串

桌面

items.seller

给定热门产品的卖家。

字符串

桌面

items.image_data

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

字符串

桌面

pos_overall

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

整数

桌面和移动

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

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

Key (results.related_searches)

Description

类型

布局

pos_overall

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

整数

桌面和移动

related_searches

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

数组

桌面和移动

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

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

Key (results.related_questions)

Description

类型

布局

项目

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

数组

桌面和移动

items.pos

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

整数

桌面和移动

items.answer

What people are saying

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

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

Key (results.what_people_are_saying)

Description

类型

布局

项目

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

数组

桌面和移动

items.url

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

整数

桌面和移动

items.title

讨论线程或内容项的标题。

字符串

桌面和移动

items.top_comments

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

字符串

桌面和移动

items.source

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

字符串

桌面和移动

items.engagement_timeframe

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

字符串

桌面和移动

Search Information

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

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

Key (results.search_information)

Description

类型

布局

query

原始搜索词。

字符串

桌面和移动

geo_location *

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

字符串

桌面

showing_results_for

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

字符串

桌面和移动

total_results_count

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

整数

桌面和移动

*仅在启用 JS 渲染时有效

Item Carousel

A carousel (item_carousel) 在 SERP 顶部显示与特定类型项目相关的图像或链接。内容和布局根据用户的搜索查询而变化，展示一系列相关项目。范围可以从产品和新闻到图像，为用户创建富有视觉吸引力且量身定制的体验。

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

Key (results.item_carousel)

Description

类型

布局

项目

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

数组

桌面

items.pos

项目在轮播中的位置。

整数

桌面

items.href

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

字符串

桌面

items.title

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

字符串

桌面

items.subtitle

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

字符串

桌面

title

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

字符串

桌面

pos_overall

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

整数

桌面

Recipes

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

...
"recipes": {
    "items": [
        {
            "pos": 1,
            "url": "https://handletheheat.com/chewy-brownies/",
            "desc": "Unsweetened cocoa powder, chocolate chips, baking soda, egg yolk, all purpose flour",
            "title": "Best Ever Chewy Brownies",
            "rating": 4.8,
            "source": "Handle the Heat",
            "duration": "45 mins"
        },
...
    ],
    "pos_overall": 1
},
...

Key (results.recipes)

Description

类型

布局

项目

带有各自详细信息的精选菜谱列表。

数组

桌面和移动

items.pos

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

整数

桌面和移动

items.url

完整菜谱的 URL。

字符串

桌面和移动

items.desc

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

字符串

桌面

items.title

菜谱的标题。

字符串

桌面和移动

items.rating

菜谱的评分。

整数

桌面和移动

items.source

菜谱所在网站的名称。

字符串

桌面和移动

items.duration

准备该菜肴所需的时间。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

Videos

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

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

Key (results.videos)

Description

类型

布局

项目

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

数组

桌面和移动

items.pos

视频在列表中的位置。

整数

桌面和移动

items.url

视频的链接。

字符串

桌面和移动

items.title

视频的标题。

字符串

桌面和移动

items.author

上传视频的帐号名称。

字符串

桌面和移动

items.source

承载视频的平台名称。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

Featured Snippet

The featured_snippet 是一种独特的 Google 搜索结果，其中在链接到该页面之前显示描述该页面的简要片段。此类突出结果会显著显示在自然搜索结果顶部，为用户提供快速获取相关信息的途径。

...
"featured_snippet": [
    {
        "url": "https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors",
        "desc": "As night length increases in the autumn, chlorophyll production slows down and then stops and eventually all the chlorophyll is destroyed. The carotenoids and anthocyanin that are present in the leaf are then unmasked and show their colors.",
        "title": "Science of Fall Colors | US Forest Service",
        "url_shown": "https://www.fs.usda.gov\u203a visit \u203a science-of-fall-colors",
        "pos_overall": 1
    }
],
...

Key (results.featured_snippet)

Description

类型

布局

url

检索用于描述页面的片段的来源网站的 URL。

字符串

桌面和移动

desc

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

字符串

桌面和移动

title

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

字符串

桌面和移动

url_shown

在 SERP 中可见的包含特色摘录的站点 URL。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

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

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

Key (results.related_searches_categorized)

Description

类型

布局

项目

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

数组

桌面

items.url

Hotels

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

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

Key (results.hotels)

Description

类型

布局

date_to

退房日期。

字符串

桌面

结果

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

数组

桌面

results.price

酒店的价格。

字符串

桌面

results.title

酒店的名称。

字符串

桌面

results.description

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

字符串

桌面

date_from

入住日期。

字符串

桌面

pos_overall

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

整数

桌面

Flights

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

...
"flights": {
    "to": "London, United Kingdom (all airports)",
    "from": "New York, NY (all airports)",
    "date_to": "Mon, Jan 29",
    "results": [
        {
            "url": "https://www.google.com/travel/flights?safe=off&sca_esv=590053957&source=flun&uitype=cuAA&hl=en&gl=us&curr=USD&tfs=CAEQAhotEgoyMDI0LTAxLTIyMgJaMGoNCAISCS9tLzAyXzI4NnIMCAISCC9tLzA0anBsGi0SCjIwMjQtMDEtMjkyAlowagwIAhIIL20vMDRqcGxyDQgCEgkvbS8wMl8yODZ6aENqUklUVmxrYjA1V2RubE9kazFCUkRSM2RrRkNSeTB0TFMwdExTMHRMWGxzWm5FeU9FRkJRVUZCUjFZMFNrMXpTVXhTTTJ0QkVnTnVXakFhQ3dpOHlnSVFBaG9EVlZORU9EQnd2TW9D",
            "type": "Nonstop",
            "price": "$423",
            "airline": "Norse Atlantic UK",
            "duration": "6h 50m"
        },
       ...
    ],
    "date_from": "Mon, Jan 22",
    "pos_overall": 1
},
...

Key (results.flights)

Description

类型

布局

to

到达机场。

字符串

桌面和移动

from

出发机场。

字符串

桌面和移动

date_to

到达日期。

字符串

桌面和移动

结果

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

数组

桌面和移动

results.url

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

字符串

桌面和移动

results.type

航班类型。

字符串

桌面

results.price

航班价格。

字符串

桌面和移动

results.airline

承运人名称。

字符串

桌面和移动

results.duration

航班持续时间。

字符串

桌面和移动

date_from

出发日期。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

Video Box

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

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

Key (results.video_box)

Description

类型

布局

url

视频的 URL。

字符串

桌面和移动

title

视频的标题。

字符串

桌面和移动

pos_overall

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

整数

桌面和移动

Local Service Ads

The local_service_ads 该功能使面向服务的专业人士（如水管工、电工、锁匠及其他本地服务提供商）能够在 Google 搜索结果页面上推广其服务。

...
"local_service_ads": {
    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall & Katt, Attorneys at Law",
            "rating": 4.4,
            "reviews_count": 254,
            "google_guaranteed": true
        },
       ...
    ],
    "pos_overall": 2
},
...

Key (results.local_service_ads)

Description

类型

布局

项目

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

数组

桌面

items.pos

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

整数

桌面

items.url

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

字符串

桌面

items.title

服务提供商的标题。

字符串

桌面

items.rating

服务提供商的评分。

整数

桌面

items.reviews_count

服务提供商的评论数量。

整数

桌面

items.google_guaranteed

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

boolean

桌面

pos_overall

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

整数

桌面

Apps

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

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

Key (results.apps)

Description

类型

布局

id

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

字符串

Mobile

url

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

字符串

Mobile

title

应用的标题。

字符串

Mobile

rating

应用的评分。

整数

Mobile

reviews_count

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

整数

Mobile

items.reviews_count

服务提供商的评论数量。

字符串

Mobile

Finance

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

HTML 示例

Key (results.finance)

Description

类型

布局

low

指定日期的最低价格。

浮点数

桌面

date

报告净资产价值的日期。

字符串

桌面

high

指定日期的最高价格。

浮点数

桌面

open

指定日期的开盘价。

浮点数

桌面

source

相关 Google Finance 源网站的 URL。

字符串

桌面

difference

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

字符串

桌面

market_cap

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

字符串

桌面

stock_name

股票的名称。

字符串

桌面

52_week_low

52 周最低价。

浮点数

桌面

52_week_high

52 周最高价。

浮点数

桌面

current_price

实时价格报价。

字符串

桌面

dividend_yield

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

浮点数

桌面

price_earning_ratio

股票的市盈率。

浮点数

桌面

JSON 示例

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

Description

类型

布局

比赛

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

数组

桌面

games.date

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

字符串

桌面

games.teams

比赛中参与的队伍

数组

桌面

games.game_type

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

字符串

桌面

games.highlight

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

字符串

桌面

games.teams.score

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

字符串

桌面

games.teams.winner

指定哪支队伍赢得了比赛

boolean

桌面

games.teams.team_name

显示参赛队伍的名称

字符串

桌面

stage

体育竞赛或锦标赛的具体阶段或阶段名称

字符串

桌面

league

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

字符串

桌面

JSON 示例

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

讨论和论坛

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

HTML 示例

键（results.discussions_and_forums）

Description

类型

布局

项目

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

最后更新于6天前

这有帮助吗？

下午好

hashtagRequest samples

hashtagRequest parameter values

hashtagGeneric

hashtagGoogle Advanced Search Operators

hashtagLocalization

hashtagPagination

hashtagContinuous scroll support

hashtagLimit per page

hashtagRequest sample

hashtagFiltering

hashtagOther

hashtagContext parameters

hashtagStructured data

hashtag输出数据字典

hashtagJSON 结构

hashtagProduct Listing Ads (PLA)

hashtagPaid

hashtagImages

hashtagOrganic

hashtag示例 1

hashtag示例 2

hashtagOrganic Videos

hashtagTop Sights

hashtagJobs

hashtagTwitter (X)

hashtagKnowledge

hashtagLocal Pack

hashtagTop Stories

hashtagPopular Products

hashtagRelated Searches

hashtagRelated Questions

hashtagWhat people are saying

hashtagSearch Information

hashtagItem Carousel

hashtagRecipes

hashtagVideos

hashtagFeatured Snippet

hashtagRelated Searches Categorized

hashtagHotels

hashtagFlights

hashtagVideo Box

hashtagLocal Service Ads

hashtagApps

hashtagFinance

hashtagHTML 示例

hashtagJSON 示例

hashtag体育比赛

hashtagHTML 示例

hashtagJSON 示例

hashtag讨论和论坛

hashtagHTML 示例

hashtagJSON 示例

Request samples

Request parameter values

Generic

Google Advanced Search Operators

Localization

Pagination

Continuous scroll support

Limit per page

Request sample

Filtering

Other

Context parameters

Structured data

输出数据字典

JSON 结构

Product Listing Ads (PLA)

Paid

Images

Organic

示例 1

示例 2

Organic Videos

Top Sights

Jobs

Twitter (X)

Knowledge

Local Pack

Top Stories

Popular Products

Related Searches

Related Questions

What people are saying

Search Information

Item Carousel

Recipes

Videos

Featured Snippet

Related Searches Categorized

Hotels

Flights

Video Box

Local Service Ads

Apps

Finance

HTML 示例

JSON 示例

体育比赛

HTML 示例

JSON 示例

讨论和论坛

HTML 示例

JSON 示例