> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/api-targets/cn/search-engines/google/search/search.md).
# 网页搜索
全面的 Google 搜索爬虫，提供自然结果、广告、摘要、热门报道等的解析后数据。
该 `google_search` 来源用于检索 Google Search（SERPs）和 Google [AI Overviews](/api-targets/cn/search-engines/google/ai-overviews.md) 结果。本子页面专门介绍与 Google 网页搜索相关的信息。要了解其他结果类型，请阅读 [**图片搜索**](/api-targets/cn/search-engines/google/search/image-search.md) 或 [**新闻搜索**](/api-targets/cn/search-engines/google/search/news-search.md).
## 请求示例
在下面的示例中，我们发出请求以获取 `2` 结果页，从第 `11` 页到第 `12` 页，搜索词为 `adidas`。API 将返回解析后的结果。
{% tabs %}
{% tab title="cURL" %}
```shell
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
}'
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
from pprint import pprint
# Structure payload.
payload = {
'source': 'google_search',
'query': 'adidas',
'start_page': 11,
'pages': 2,
'parse': True,
}
# 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())
```
{% endtab %}
{% tab title="Node.js" %}
```javascript
const https = require("https");
const username = "USERNAME";
const password = "PASSWORD";
const body = {
source: "google_search",
query: "adidas",
start_page: 11,
pages: 2,
parse: true,
};
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();
```
{% endtab %}
{% tab title="HTTP" %}
```http
https://realtime.oxylabs.io/v1/queries?source=google_search&query=adidas&start_page=11&pages=2&parse=true&access_token=12345abcde
```
{% endtab %}
{% tab title="PHP" %}
```php
'google_search',
'query' => 'adidas',
'start_page' => 11,
'pages' => 2,
'parse' => true,
);
$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);
```
{% endtab %}
{% tab title="Golang" %}
```go
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,
}
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))
}
```
{% endtab %}
{% tab title="C#" %}
```csharp
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 = {
source = "google_search",
query = "adidas",
start_page = 11,
pages = 2,
parse = true,
};
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);
}
}
}
```
{% endtab %}
{% tab title="Java" %}
```java
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);
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();
}
}
```
{% endtab %}
{% tab title="JSON" %}
```json
{
"source": "google_search",
"query": "adidas",
"start_page": 11,
"pages": 2,
"parse": true
}
```
{% endtab %}
{% endtabs %}
我们的示例使用同步 [**Realtime**](/products/cn/web-scraper-api/integration-methods/realtime.md) 集成方式。如果你想使用 [**Proxy Endpoint**](/products/cn/web-scraper-api/integration-methods/proxy-endpoint.md) 或异步 [**Push-Pull**](/products/cn/web-scraper-api/integration-methods/push-pull.md) 集成，请参考 [**集成方法**](/products/cn/web-scraper-api/integration-methods.md) 部分。
## 请求参数值
### 通用
抓取 Google 网页搜索结果的基本设置和自定义选项。
参数 描述 默认值 source设置爬虫。使用 google_search. – query要搜索的关键词或短语。 – render设置为时启用 JavaScript 渲染 html. 更多信息 . – parse设置为时返回解析后的数据 true。查看输出 数据字典 falsecallback_url指向你的回调端点的 URL。 更多信息 – user_agent_type设备类型和浏览器。完整列表可在 此处 desktop
\- 必填参数
#### Google 高级搜索运算符
在抓取时，你可能会发现将 Google 高级搜索运算符与查询结合使用很有用。这样可自定义搜索范围，确保结果更相关、更聚焦。了解这些特殊命令 [**此处**](https://ahrefs.com/blog/google-advanced-search-operators/) 和 [**此处**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators)。请看下面的示例。
```json
{
"source": "google_search",
"query": "iphone 15 launch inurl:apple"
}
```
### 本地化
将搜索结果适配到特定地理位置、区域和语言。
参数 描述 默认值 geo_location结果应适配的地理位置。正确使用此参数对获取正确数据极其重要。有关更多信息，请阅读我们建议的 geo_location 参数结构 此处 . - localeAccept-Language 请求头值，可更改你的 Google 搜索页面网页界面语言。 更多信息 -
### 分页
用于管理搜索结果分页和检索的控制项。
参数 描述 默认值 start_page起始页码。 1pages要检索的页数。 1limit每页要检索的结果数量。 10context:limit_per_page使用相同 IP 地址和会话（已设置 Cookie）抓取多个页面。通过在 JSON 数组中使用 page 键指定页码，并使用 limit 键指定每页的自然结果数量，可以最大限度减少跨页面出现重复自然结果的可能性（例如，第一页的最后一个自然结果与第二页的第一个自然结果相同）。 查看示例 . -
#### 连续滚动支持
网页爬虫API 完全支持 Google Search 连续滚动。它会自动检测连续滚动布局，高效加载所请求的自然结果，无需任何额外参数。
#### 每页限制
{% hint style="warning" %}
由于 Google 最近的限制变更，我们已调整 网页爬虫API 的行为。每页最大结果数将与 Google 的自然结果输出一致，通常为 10 条结果。
{% endhint %}
要使用此功能，请包含一个 JSON 数组，其中的 JSON 对象包含以下数据：
参数 描述 示例 page你想抓取的页码。任何大于 0 的整数都可以 1limit该页上的结果数量。任何介于 1 和 100 （含）之间的整数都可以。 90
#### 请求示例
```json
{
"source": "google_search",
"query": "adidas",
"parse": true,
"context": [
{
"key": "limit_per_page",
"value": [
{"page": 1, "limit": 10},
{"page": 2, "limit": 90}
]
}]
}
```
### 过滤
用于根据各种条件过滤和优化搜索结果的选项。了解如何使用 context 参数 [**此处**](#context-parameters).
参数 描述 默认值 context:filter将此参数的值设置为 0 可以查看原本会因与其他结果相似而被排除的结果。 1context:safe_search安全搜索。设置为 true 即可启用。 falsecontext:udmudm 参数允许在不同搜索标签之间切换，例如图片、地点或视频，以自定义显示的结果类型。查看可接受的值 此处 - context:tbm待匹配或 tbm 参数。可用值： bks （书籍）， isch （图片）， nws （新闻）， vid （视频）， lcl （本地）结果。 - context:tbs此参数类似于一个容器，用于存放较隐蔽的 Google 参数，例如按日期限制/排序结果以及其他过滤器，其中有些取决于 tbm 参数。更多信息 此处 -
{% hint style="warning" %}
`udm` 和 `tbm` context 参数不能在单个抓取请求中同时使用；请只选择一个。两者同时使用可能会导致冲突或意外行为。
{% endhint %}
### 其他
用于特殊需求的额外高级设置和控件。
参数 描述 默认值 context:fpstate将 fpstate 值设为 aig 会让 Google 加载更多应用。此参数仅在与 render 参数一起使用时才有用。 - context:nfprtrue 将关闭拼写自动更正false
### 上下文参数
所有上下文参数都应添加到 `context` 数组中的对象，包含 `键` 和 `值` 对，例如：
```json
...
"context": [
{
"key": "filter",
"value": "0"
}
]
...
```
## 结构化数据
网页爬虫API能够提取包含 Google 搜索结果的 HTML 或 JSON 对象，并为结果页的各个元素提供结构化数据。
google_search 结构化输出
{% hint style="info" %}
元素的组成可能会因是否为 **desktop** 或 **移动端** 搜索。
{% endhint %}
为帮助你识别某些元素，请参考每种 Google 搜索结果类型的数据字典，无论它是来自桌面端还是移动端搜索。
## 输出数据字典
可通过右侧导航或向下滚动页面浏览详细信息。
#### **JSON 结构**
Google Web Search 结构化输出包含如下字段： `URL`, `page`, `results`以及其他字段。下表列出了我们解析的每个 SERP 功能的详细清单，以及其描述和数据类型。表中还包含一些元数据。
{% hint style="info" %}
某一特定结果类型的项目和字段数量可能会因搜索查询而异。
{% endhint %}
键名 描述 类型 urlGoogle 搜索页面的 URL。 字符串 page相对于 Google SERP 分页的页码。 整数 results包含搜索结果的字典。 对象 results.pla包含各自详细信息的商品列表广告列表。 对象 results.paid包含各自详细信息的赞助结果列表。 数组 results.images包含各自详细信息的图片结果列表。 对象 results.flights包含各自详细信息的航班列表。 对象 results.organic包含各自详细信息的非付费列表。 数组 results.organic_videos包含各自详细信息的自然视频列表。 数组 results.top_sights包含各自详细信息的著名地标或景点列表。 数组 results.jobs包含各自详细信息的职位列表。 对象 results.local_service_ads赞助的本地服务提供商列表。 对象 results.video_boxesSERP 中的视频框及其详细信息。 数组 results.recipes包含各自详细信息的食谱列表。 对象 results.twitter包含各自详细信息的 Twitter (X) 结果列表。 数组 results.local_pack包含与搜索相关的本地商家列表。 对象 results.item_carousel包含各自详细信息的信息性查询示例项目列表。 对象 results.videos包含各自详细信息的视频列表。 对象 results.hotels与搜索查询所用地点相关的酒店列表。 对象 results.apps包含各自详细信息的应用列表。 数组 results.finance公司财务数据摘要，包括股价、市值和其他关键指标。 对象 results.sports_games近期体育赛事信息，详述比分、球队、比赛类型和精彩片段。 对象 results.discussions_and_forums包含 URL、标题、来源和评论数的讨论线程和论坛帖子列表。 对象 results.featured_snippet从 SERP 自然结果部分提取的特定结果列表。 数组 results.top_stories当搜索查询被识别为新闻导向时，包含各自详细信息的文章列表。 对象 results.popular_products包含各自详细信息的 Google Shopping 产品列表的非付费和自然展示列表。 对象 results.related_searches在搜索页面不同位置显示的一个或多个相关搜索块列表。 数组 results.related_questions包含各自详细信息的相关疑问搜索查询列表。 对象 results.what_people_are_saying包含 URL、标题、来源、热门评论、参与度和时间范围的讨论线程和论坛帖子列表。 数组 results.search_information已提交搜索查询的详细信息列表。 对象 total_results_count搜索查询找到的结果总数。 字符串 last_visible_page标识搜索查询结果页中可见最大页码的值。（通过滚动触发加载更多结果时为 -1）。 整数 parse_status_code解析任务的状态码。您可以查看所述的解析器状态码 此处 整数 created_at爬取任务创建时的时间戳。 时间戳 updated_at爬取任务完成时的时间戳。 时间戳 job_id与爬取任务关联的任务 ID。 字符串 status_code爬取任务的状态码。您可以查看所述的爬虫状态码 此处 整数 parser_type用于拆解 HTML 内容的解析器类型。 字符串
{% hint style="info" %}
在以下部分中，当某种结果类型有多个项目可用时，解析后的 JSON 代码片段会被缩短。
{% endhint %}
### 产品列表广告（PLA）
该 `pla` 搜索结果中的该部分指产品列表广告，也称为 Google Shopping 广告，通常以轮播形式突出显示在搜索页面顶部。
```json
...
"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） 描述 类型 布局 items页面中可用的所有 PLA。 数组 桌面端和移动端 items.pos用于表示某个项目在 PLA 结果中的位置。 整数 桌面端和移动端 items.title列表广告中产品的标题。 字符串 桌面端和移动端 items.url产品的 URL 字符串 桌面端和移动端 items.price列表广告中产品的价格。 字符串 桌面端和移动端 items.seller列表广告中产品的卖家。 字符串 桌面端和移动端 items.url_image产品图片的 URL。 字符串 桌面端 items.image_data产品缩略图的 Base64 编码图片。 字符串 桌面端和移动端 pos_overall用于表示 PLA SERP 功能在 SERP 中的位置。 整数 桌面端和移动端
### 付费
该 `paid` 该部分指由 Google Ads 提供支持的广告，通常显示在自然（非付费）结果之上。
键（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 图片搜索结果抓取的数据结构不同。
键（results.images） 描述 类型 布局 items包含各自详细信息的图片列表。 数组 桌面端和移动端 items.alt图片的替代文本。 字符串 桌面端和移动端 items.pos表示列表中图片位置的唯一标识。 整数 桌面端和移动端 items.url包含该图片的网页 URL。 字符串 桌面端和移动端 pos_overall表示 Images SERP 功能在 SERP 中的位置。 整数 桌面端和移动端
### 自然
该 `自然` 该部分指的是 Google 自然搜索结果中的非付费列表，这些列表通过 Google 的算法根据相关性确定。它们显示在搜索页面上的付费广告下方。
#### 示例 1
键（results.organic) 描述 类型 布局 pos表示给定项目在自然结果中的位置的指示器。 整数 桌面端和移动端 url自然结果的 URL。 字符串 桌面端和移动端 desc自然结果的简短描述。 字符串 桌面端和移动端 title自然结果的标题。 字符串 桌面端和移动端 images自然结果的 base64 编码缩略图。 字符串 桌面端和移动端 sitelinks对象包含 `expanded` 或 `inline` 元素，其中提供有关站点链接的更多详细信息。 对象 桌面端和移动端 站点链接.expanded/inline自然结果的站点链接列表。键名（内联/展开) 指定 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、描述。
键（results.organic_videos） 描述 类型 布局 pos表示给定项目在自然视频结果中的位置。 整数 桌面端 url视频的 URL。 字符串 桌面端 desc视频的简短描述。 字符串 桌面端 title视频标题。 字符串 桌面端 pos_overall表示自然视频结果在 SERP 中的位置。 整数 桌面端
### 热门景点
该 `results.top_sights` 包含通常与搜索地点或主题相关的著名地标或景点列表。每个项目都包含如在列表中的位置和标题等详细信息。
键（results.top_sights） 描述 类型 布局 items热门景点及其各自详细信息的列表。 数组 桌面端 items.posTop Sights SERP 功能中结果的位置。 整数 桌面端 items.title旅游景点的标题。 字符串 桌面端 pos_overall表示 Top Sights 结果在 SERP 中的位置。 整数 桌面端
### 职位
该 `results.jobs` 包含从搜索结果中提取的职位列表。每个列表都包含指向职位发布页面的 URL、职位标题、来源、雇主和地点等详细信息。这些列表来自 Google 索引的各种招聘网站、职业网站和其他平台。
键（results.jobs） 描述 类型 布局 列表页面中所有职位列表的数组。 数组 桌面端 listings.url完整职位列表的 URL。 字符串 桌面端 listings.title职位名称。 字符串 桌面端 listings.source包含原始招聘信息的来源。 字符串 桌面端 listings.employer招聘该职位的组织。 字符串 桌面端 listings.location该职位的地点。 字符串 桌面端 pos_overall表示 Jobs SERP 功能在 SERP 中的位置。 整数 桌面端
### Twitter（X）
该 `twitter` 该功能经常出现在品牌、电影、音乐人及其他名人的结果中，通常位于品牌网站的搜索结果下方。此功能提供指向品牌 Twitter 订阅源的直接链接，并展示其最新推文的轮播。
键（results.twitter） 描述 类型 布局 pos表示给定项目在自然结果中的位置的指示器。 整数 桌面端 url包含 Twitter（X）帖子资料的个人资料 URL。 字符串 桌面端 items包含各自详情的 Twitter（X）帖子列表。 数组 桌面端 items.pos表示给定推文在 Twitter（X）SERP 功能中的位置。 字符串 桌面端 items.urlTwitter（X）帖子的 URL。 字符串 桌面端 items.content用于表示相关 Twitter（X）帖子全部文本的简短描述。 字符串 桌面端 items.timeframe描述该推文创建于多久之前。 字符串 桌面端 titleTwitter（X）个人资料的标题。 字符串 桌面端 pos_overall表示 Twitter 结果在 SERP 中的位置。 整数 桌面端
### 本地包
该 `local_pack` 根据用户位置或指定搜索位置显示前三个本地搜索结果，并包含地图和附加信息。
键（results.local_pack） 描述 类型 布局 items包含各地点及其对应详情的列表。 数组 桌面端和移动端 items.cid分配给特定商家列表的唯一标识编号。 字符串 桌面端和移动端 items.pos本地结果在本地包中的位置。 整数 桌面端和移动端 items.title本地实体的标题。 字符串 桌面端和移动端 items.rating本地实体的评分。 整数 桌面端和移动端 items.address本地实体的地址。 字符串 桌面端和移动端 items.rating_count本地实体的评分数量。 整数 桌面端和移动端 pos_overall表示 Local Pack 结果在 SERP 中的位置。 整数 桌面端和移动端
### 头条新闻
`top_stories` 是 Google Search 中针对新闻类查询展示的专门版块。
键（results.top_stories） 描述 类型 布局 items精选新闻文章及其各自详情的列表。 数组 桌面端和移动端 items.pos文章在 Top Stories SERP 功能中的位置。 整数 桌面端和移动端 items.url完整文章的网址。 字符串 桌面端和移动端 items.title文章标题。 字符串 桌面端和移动端 items.sectionTop Stories 版块的名称。 字符串 移动端 items.source发布文章的网站名称。 字符串 桌面端和移动端 items.timeframe描述文章发表于多久之前。 字符串 桌面端 pos_overall表示 Top Stories SERP 功能在 SERP 中的整体位置。 整数 桌面端和移动端
### 热门产品
该 `popular_products` SERP 功能会展示一个由各种产品组成的轮播，其排序依据是受欢迎程度和与用户查询的相关性。这不同于受广告主影响的 Product Listing Ads (PLAs)。值得注意的是，多个 `popular_products` 轮播可能会出现在单个 SERP 页面上。
键（results.popular_products） 描述 类型 布局 items热门产品及其各自详情的列表。 数组 桌面端和移动端 items.pos用于表示某个热门产品在 Popular Products SERP 功能中的位置的唯一标识。 整数 桌面端和移动端 items.url该产品 Google Shopping 页面的网址。 字符串 桌面端和移动端 items.title产品标题。 字符串 桌面端和移动端 items.token产品 token（与 google_shopping_product source 配合使用，适用于卖家、定价、产品详情）。 字符串 桌面端和移动端 items.rating给定热门产品的评分。 字符串 桌面端和移动端 items.sellers提供该产品的卖家列表，以及各自的详细信息。 数组 桌面端和移动端 items.sellers.pos卖家在卖家列表中的位置。 整数 桌面端和移动端 items.sellers.price_str卖家给出的产品价格。 字符串 桌面端和移动端 items.sellers.seller_name产品卖家名称。 字符串 桌面端和移动端 items.currency标价的货币代码。 字符串 桌面端和移动端 items.image_data产品缩略图的 Base64 编码图片。 字符串 桌面端和移动端 items.description产品卖家的简短描述。 字符串 桌面端和移动端 items.rating_count产品的评分数量。 整数 桌面端和移动端 pos_overall表示 Popular Products SERP 功能在 SERP 中的整体位置。 整数 桌面端和移动端
### 相关搜索
该 `related_searches` 该 SERP 功能会显示与初始搜索关键词相关的替代搜索查询，通常位于 SERP 底部。
键（results.related_searches） 描述 类型 布局 pos_overall表示此相关搜索模块在搜索页面中的整体位置。 整数 桌面端和移动端 related_searches此模块中的相关搜索字符串列表。 数组 桌面端和移动端
### 相关问题
该 `related_questions` 该功能位于主搜索结果下方，展示与用户原始搜索查询直接相关的问题列表。通过提供精选的相关问题，用户可以探索主题的不同方面，从而提升整体搜索体验。
键（results.related_questions） 描述 类型 布局 items包含所有相关问题的列表。 数组 桌面端和移动端 items.pos用于表示任一相关问题在 Related Questions SERP 功能中的位置的唯一标识。 整数 桌面端和移动端 items.answer相关问题的答案。 字符串 桌面端和移动端 items.source包含描述问题答案来源的值。 对象 桌面端和移动端 items.source.url用于获取答案的网站 URL。 字符串 桌面端 items.source.title包含答案的网站标题。 字符串 桌面端 items.source.url_shown显示在答案下方的短 URL。 字符串 桌面端和移动端 items.question相关问题部分中的问题。 字符串 桌面端和移动端 pos_overall表示 Related Questions SERP 功能在 SERP 中的整体位置。 整数 桌面端和移动端
### 人们在说什么
该 `what_people_are_saying` 当与搜索查询相关的论坛、社交媒体或社区平台上有相关帖子时，该部分会出现在 Google 搜索结果中。此部分通常会显示来自 Reddit、TikTok 和其他讨论论坛等平台的内容。
键（results.what_people_are_saying） 描述 类型 布局 items包含所有讨论论坛或社交媒体内容项的列表。 数组 桌面端和移动端 items.url讨论线程或社交媒体内容页面的 URL。 整数 桌面端和移动端 items.title讨论线程或内容的标题。 字符串 桌面端和移动端 items.top_comments如果显示，则为讨论线程中的置顶评论。 字符串 桌面端和移动端 items.source托管该内容的平台或网站名称。 字符串 桌面端和移动端 items.engagement_timeframe评论数和活跃时间范围（例如，“45 条评论，2 天前”）。 字符串 桌面端和移动端
### 搜索信息
该 `search_information` 该功能提供有关搜索查询的结构化信息。
键（results.search_information） 描述 类型 布局 query原始搜索词。 字符串 桌面端和移动端 geo_location *表示与搜索相关的特定地理区域。 字符串 桌面端 showing_results_for搜索结果所显示对应的搜索词。如果 Google 自动更正了提供的搜索词，`query` 和 `showing_results_for` 可能不同。 字符串 桌面端和移动端 total_results_count该搜索词找到的结果总数。 整数 桌面端和移动端
\*仅适用于 JS 渲染
### 轮播
一个轮播（`item_carousel`）与某一特定类型项目相关的图片或链接会显示在 SERP 的最顶部。内容和布局会根据用户的搜索查询而变化，展示一组选定的相关项目。内容范围可以从产品和新闻到图片，为用户创造一个视觉上吸引且量身定制的体验。
键 (results.item_carousel) 描述 类型 布局 items以轮播形式展示的一系列项目及其各自详情。 数组 桌面端 items.pos项目在轮播中的位置。 整数 桌面端 items.href指向轮播中该项目的 Google SERP 超链接。 字符串 桌面端 items.title轮播中实体的名称/标题。 字符串 桌面端 items.subtitle标题中该实体的附加详情。 字符串 桌面端 title轮播部分的标题。该标题与搜索查询相关。 字符串 桌面端 pos_overallItem Carousel 结果在 SERP 中的位置指示。 整数 桌面端
### 食谱
该 `recipes` Google 的 SERP 功能会在搜索结果顶部展示针对特定菜肴的精选烹饪步骤、配料、评分和来源。
键 (results.recipes) 描述 类型 布局 items精选食谱及其各自详情的列表。 数组 桌面端和移动端 items.pos食谱在 Recipes SERP 功能中的位置。 整数 桌面端和移动端 items.url完整食谱的 URL。 字符串 桌面端和移动端 items.desc从原始文章中检索到的食谱简短描述。 字符串 桌面端 items.title食谱标题。 字符串 桌面端和移动端 items.rating食谱评分。 整数 桌面端和移动端 items.source食谱所在网站的名称。 字符串 桌面端和移动端 items.duration准备这道菜所需的时间。 字符串 桌面端和移动端 pos_overallRecipes 结果在 SERP 中的位置指示。 整数 桌面端和移动端
### 视频
该 `videos` Google 搜索引擎结果页中的该功能会展示与用户搜索查询相关的视频内容精选，包括缩略图、标题和来源信息。
键 (results.videos) 描述 类型 布局 items包含视频部分所有结果的列表。 数组 桌面端和移动端 items.pos视频在列表中的位置。 整数 桌面端和移动端 items.url视频链接。 字符串 桌面端和移动端 items.title视频标题。 字符串 桌面端和移动端 items.author上传视频的个人资料名称。 字符串 桌面端和移动端 items.source托管该视频的平台名称。 字符串 桌面端和移动端 pos_overallVideos 结果在 SERP 中的位置指示。 整数 桌面端和移动端
### 精选摘要
该 `featured_snippet` 这是一个独特的 Google 搜索结果，会在页面链接之前显示对该页面的简要摘要。这些高亮结果会显著显示在自然搜索结果顶部，为用户提供快速访问相关信息的途径。
键 (results.featured_snippet) 描述 类型 布局 url提取该页面摘要的网页 URL。 字符串 桌面端和移动端 desc包含特定搜索结果描述的摘要。 字符串 桌面端和移动端 title提取页面摘要的文章名称。 字符串 桌面端和移动端 url_shownSERP 中可见的精选摘要所在网站的 URL。 字符串 桌面端和移动端 pos_overallFeatured Snippet 结果在 SERP 中的位置指示。 整数 桌面端和移动端
### 酒店
Google `hotels` 该功能会直接在搜索结果中展示酒店信息。当用户在 Google 上搜索酒店或住宿相关查询时，搜索引擎可能会在结果页顶部显示一个专门的酒店模块，为相关选项提供便捷且醒目的概览。
键 (results.hotels) 描述 类型 布局 date_to退房日期。 字符串 桌面端 results包含酒店所有详情的列表。 数组 桌面端 results.price酒店价格。 字符串 桌面端 results.title酒店名称。 字符串 桌面端 results.description酒店名称下方可见的简短描述。 字符串 桌面端 date_from入住日期。 字符串 桌面端 pos_overallHotels 结果在 SERP 中位置的指示。 整数 桌面端
### 航班
该 `flights` 该功能会显示一个包含与相关搜索查询关联的结构化航班选项的模块，让用户可以直接在搜索结果中比较不同选项。
键 (results.flights) 描述 类型 布局 to到达机场。 字符串 桌面端和移动端 from出发机场。 字符串 桌面端和移动端 date_to到达日期。 字符串 桌面端和移动端 results精选航班及其各自详情的列表。 数组 桌面端和移动端 results.url指向 Google Flights 页面、列出某家航空公司全部航班的链接。 字符串 桌面端和移动端 results.type航班类型。 字符串 桌面端 results.price航班价格。 字符串 桌面端和移动端 results.airline承运航空公司名称。 字符串 桌面端和移动端 results.duration航班时长。 字符串 桌面端和移动端 date_from出发日期。 字符串 桌面端和移动端 pos_overallFlights 结果在 SERP 中位置的指示。 整数 桌面端和移动端
### 视频框
该 `video_boxes` 数组包含搜索结果页顶部的特定视频结果，由 Google 选为与查询最相关的内容。
键 (results.video_boxes) 描述 类型 布局 pos_overall视频框的总体位置。 整数 桌面端和移动端 title视频标题。 字符串 桌面端和移动端 url视频的 URL。 字符串 桌面端和移动端
### 本地服务广告
该 `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,
},
...
],
"pos_overall": 2
},
...
键 (results.local_service_ads) 描述 类型 布局 items包含服务提供商及其各自详情的列表。 数组 桌面端 items.pos服务广告在 Local Services Ads SERP 功能中的位置。 整数 桌面端 items.url指向本地服务搜索页中该服务的链接。 字符串 桌面端 items.title服务提供商的标题。 字符串 桌面端 items.rating服务提供商的评分。 整数 桌面端 items.reviews_count服务提供商的评论数量。 整数 桌面端 pos_overallLocal Service Ads 结果在 SERP 中位置的指示。 整数 桌面端
### 应用
该 `apps` 该 SERP 功能会根据用户的查询显示相关应用，提供价格、评分等关键信息。对于应用开发者和发布者来说，这一功能是一个有价值的平台，可直接在 Google 搜索结果页提升其移动应用的可见性和互动度。
键 (results.apps) 描述 类型 布局 id应用在可用应用商店中的 ID。 字符串 移动端 url包含应用完整信息的应用商店 URL，显示在 SERP 中。 字符串 移动端 title应用标题。 字符串 移动端 rating应用评分。 整数 移动端 reviews_count应用商店中该 Apps SERP 结果可用的评论总数。 整数 移动端 items.reviews_count服务提供商的评论数量。 字符串 移动端
### **财经**
公司财务数据摘要，包括股价、市值和其他关键指标。
#### **HTML 示例**
键 (results.sports_games) 描述 类型 布局 games一个数组，提供多场体育比赛的信息 数组 桌面端 games.date比赛计划举行或发生的日期和时间 字符串 桌面端 games.teams比赛涉及的球队 数组 桌面端 games.game_type正在进行的比赛类型，例如常规赛、季后赛、冠军赛等。 字符串 桌面端 games.highlight指向比赛中值得关注的精彩片段的链接，如关键进球等。 字符串 桌面端 games.teams.score比赛中每支球队获得的分数或得分 字符串 桌面端 games.teams.winner指定哪支球队赢得比赛 布尔值 桌面端 games.teams.team_name显示比赛涉及球队的名称 字符串 桌面端 阶段体育竞赛或锦标赛的特定阶段。 字符串 桌面端 联赛指负责组织该比赛的体育联赛或机构 字符串 桌面端
#### **JSON 示例**
```json
...
"sports_games": {
"games": [
...
{
"date": "昨天",
"teams": [
{
"score": "75",
"winner": false,
"team_name": "Barcelona"
},
{
"score": "77",
"winner": true,
"team_name": "Olympiacos"
}
],
"game_type": "决赛",
"highlight": "https://stories.euroleague.net/games/329003-20240424-Barcelona-vs-Olympiacos-Piraeus.html"
},
...
],
"stage": "四分之一决赛",
"league": "EuroLeague"
},
...
```
### 讨论和论坛
包含 URL、标题、来源和评论数的讨论线程和论坛帖子列表。
#### **HTML 示例**
键 (results.discussions_and_forums) 描述 类型 布局 itemsGoogle 已编入索引的论坛或讨论线程中的项目或条目数组 数组 桌面端 items.pos表示某个项目在所有 Discussions and Forums 结果中的位置的标识。 整数 桌面端 items.url指向特定论坛帖子或讨论线程的 URL 链接 字符串 桌面端 items.title论坛帖或讨论主题的标题或主旨 字符串 桌面端 items.source承载该论坛或讨论的来源 字符串 桌面端 items.timeframe论坛帖子或讨论的时间范围或日期 字符串 桌面端 items.comments_count论坛帖子或讨论线程收到的评论或回复数量 字符串 桌面端 pos_overallDiscussions and Forums SERP 功能在 SERP 中位置的指示。 整数 桌面端
#### **JSON 示例**
```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": "1年",
"comments_count": "20+ 条评论"
},
...
],
"pos_overall": 7
}
},
...
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developers.oxylabs.io/api-targets/cn/search-engines/google/search/search.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
