> 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/sou-suo-yin-qing/google/search/search.md).
# 网页搜索
该 `google_search` 数据源旨在检索 Google Search (SERPs) 和 Google AI Overviews 结果。此子页面专门介绍与 Google Web Search 相关的信息。要探索其他结果类型，请阅读 [**图片搜索**](/api-targets/cn/sou-suo-yin-qing/google/search/image-search.md) 或[ **新闻搜索**](/api-targets/cn/sou-suo-yin-qing/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
# 结构化负载。
payload = {
'source': 'google_search',
'query': 'adidas',
'start_page': 11,
'pages': 2,
'parse': True,
}
# 获取响应。
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# 将格式化后的响应打印到标准输出。
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 = new {
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 Web 搜索结果的基本设置和自定义选项。
参数 说明 默认值 source设置爬虫。 google_searchquery要搜索的关键词或短语。 - 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-parameters).
参数 说明 默认值 context:filter将此参数的值设为 0 可以让你看到原本会因与其他结果相似而被排除的结果。 1context:safe_search安全搜索。设置为 true 以启用。 falsecontext:udmudm 参数可在不同搜索标签之间切换，例如图片、地点或视频，以自定义显示的结果类型。查看可接受的值 此处 - context:tbm待匹配或 tbm 参数。可接受的值有： app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl - context:tbs此参数类似于用于其他较隐蔽的 Google 参数的容器，例如按日期限制/排序结果以及其他筛选条件，其中部分取决于 tbm 参数（例如 tbs=app_os:1 仅可在 tbm 值 app）下使用。更多信息 此处 -
{% hint style="warning" %}
`udm` 和 `tbm` 上下文参数不能在单个抓取请求中同时使用；请只选择一个。同时使用两者可能导致冲突或意外行为。
{% 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.knowledge从知识面板中检索到的相关信息列表。 对象 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图片的 alt 文本。 字符串 桌面端和移动端 items.pos表示图片在列表中位置的唯一标识。 整数 桌面端和移动端 items.url包含该图片的网页 URL。 字符串 桌面端和移动端 pos_overall表示 Images SERP 功能在 SERP 中位置的标识。 整数 桌面端和移动端
### 自然结果
该 `organic` 部分指 Google 自然搜索结果中的非付费列表，这些结果由 Google 的算法根据相关性确定。这些列表显示在搜索页面中的付费广告下方。
#### 示例 1
键（results.organic） 说明 类型 布局 pos表示给定项目在自然结果中位置的标识。 整数 桌面端和移动端 url自然结果的 URL。 字符串 桌面端和移动端 desc自然结果的简短描述。 字符串 桌面端和移动端 title自然结果的标题。 字符串 桌面端和移动端 images自然结果的 base64 编码缩略图。 字符串 桌面端和移动端 sitelinks对象包含 `expanded` 或 `inline` 元素，其中含有关于 sitelinks 的更多详细信息。 对象 桌面端和移动端 sitelinks.expanded/inline自然结果的站点链接列表。键名（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、描述。
键（results.organic_videos） 说明 类型 布局 pos表示给定项目在自然视频结果中位置的标识。 整数 桌面端 url视频的 URL。 字符串 桌面端 desc视频的简短描述。 字符串 桌面端 title视频标题。 字符串 桌面端 pos_overall表示自然视频结果在 SERP 中位置的标识。 整数 桌面端
### 热门景点
该 `results.top_sights` 包含通常与搜索地点或主题相关的著名地标或景点列表。每个项目都包含诸如列表中的位置和标题等详细信息。
键（results.top_sights） 说明 类型 布局 items包含各自详细信息的热门景点列表。 数组 桌面端 items.posTop Sights 结果在 Top Sights SERP 功能中的位置。 整数 桌面端 items.title旅游景点的标题。 字符串 桌面端 pos_overall表示 Top Sights 结果在 SERP 中位置的标识。 整数 桌面端
### 职位
该 `results.jobs` 包含从搜索结果中提取的职位列表。每个条目都包含详细信息，例如指向职位发布的 URL、职位名称、来源、雇主和地点。这些列表来自 Google 已索引的各种招聘网站、职业网站和其他平台。
键（results.jobs） 说明 类型 布局 listings页面内所有可用职位列表的数组。 数组 桌面端 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 中位置的标识。 整数 桌面端
### 知识
该 `knowledge` 搜索结果中的该部分会在搜索人物、地点、组织或集成到 Knowledge Graph 中的实体时，在右侧显示 Google 知识面板数据。
键（results.knowledge） 说明 类型 布局 title知识面板的标题。 字符串 桌面端和移动端 images标题旁边使用的图片列表。 数组 桌面端 factoids知识面板中使用的所有事实列表。 数组 桌面端和移动端 factoids.links与给定 factoid 项相关的所有链接列表。 数组 桌面端和移动端 factoids.links.href指向给定 factoid 的 Google 搜索结果页面的超链接。 字符串 桌面端和移动端 factoids.links.title与该 factoid 相关的任何链接页面的描述。 字符串 桌面端和移动端 factoids.titlefactoid 部分的名称。 字符串 桌面端和移动端 factoids.contentfactoid 的描述。 字符串 桌面端和移动端 profiles知识面板中列出的社交媒体资料列表。 字符串 桌面端 profiles.url指向社交媒体资料的链接。 字符串 桌面端 profiles.title社交媒体资料的标题。 字符串 桌面端 subtitle对标题中描述实体的简短说明。 字符串 桌面端和移动端 description表示知识面板中该实体主要信息的描述。 字符串 桌面端和移动端 related_searches包含各自详细信息的相关搜索列表。 数组 桌面端 related_searches.url相关搜索页面的 URL。 字符串 桌面端 related_searches.title相关搜索页面的标题。 字符串 桌面端 related_searches.section_title相关搜索部分的名称。 字符串 桌面端
### 本地结果包
该 `local_pack` 根据用户位置或指定搜索位置显示前三个本地搜索结果，包括地图和附加信息。
键 (results.local_pack) 说明 类型 布局 items位置列表及其各自详情。 数组 桌面端和移动端 items.cid分配给特定商家列表的唯一识别号。 字符串 桌面端和移动端 items.pos本地结果在本地包中的位置。 整数 桌面端和移动端 items.title本地实体的标题。 字符串 桌面端和移动端 items.rating本地实体的评分。 整数 桌面端和移动端 items.address本地实体的地址。 字符串 桌面端和移动端 items.rating_count本地实体的评分数量。 整数 桌面端和移动端 pos_overall表示本地包结果在 SERP 中的位置。 整数 桌面端和移动端
### 热门资讯
`top_stories` 是 Google 搜索中针对新闻类查询显示的专用版块。
键 (results.top_stories) 说明 类型 布局 items精选新闻文章列表及其各自详情。 数组 桌面端和移动端 items.pos文章在热门资讯 SERP 功能中的位置。 整数 桌面端和移动端 items.url完整文章的 URL。 字符串 桌面端和移动端 items.title文章标题。 字符串 桌面端和移动端 items.section热门资讯版块的名称。 字符串 移动端 items.source文章发布网站的名称。 字符串 桌面端和移动端 items.timeframe描述文章的发布时间。 字符串 桌面端 pos_overall表示热门资讯 SERP 功能在 SERP 中的整体位置。 整数 桌面端和移动端
### 热门商品
该 `popular_products` SERP 功能展示一个由各种商品组成的轮播，商品根据其受欢迎程度和与用户查询的相关性确定。这不同于受广告主影响的商品列表广告（PLAs）。值得注意的是，多个 `popular_products` 轮播可能会出现在同一个 SERP 页面上。
键 (results.popular_products) 说明 类型 布局 items热门商品列表及其各自详情。 数组 桌面端和移动端 items.pos给定热门商品在热门商品 SERP 功能中的位置的唯一指示符。 整数 桌面端和移动端 items.url商品的 Google Shopping 页面 URL。 字符串 桌面端和移动端 items.title商品标题。 字符串 桌面端和移动端 items.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表示热门商品 SERP 功能在 SERP 中的整体位置。 整数 桌面端和移动端
### 相关搜索
该 `related_searches` 该 SERP 功能显示与初始搜索关键词相关的替代搜索查询，通常位于 SERP 底部。
键 (results.related_searches) 说明 类型 布局 pos_overall表示此相关搜索块在搜索页面中的整体位置。 整数 桌面端和移动端 related_searches此块中的相关搜索字符串列表。 数组 桌面端和移动端
### 相关问题
该 `related_questions` 该功能位于主要搜索结果下方，直接展示一组与用户原始搜索查询密切相关的问题。通过提供精选的相关问题，用户可以探索主题的不同方面，从而提升整体搜索体验。
键（results.related_questions） 说明 类型 布局 items包含所有相关问题的列表。 数组 桌面端和移动端 items.pos用于表示给定相关问题在“相关问题”SERP 功能中的位置的唯一标识符。 整数 桌面端和移动端 items.answer相关问题的答案。 字符串 桌面端和移动端 items.source包含描述该问题答案来源的值。 对象 桌面端和移动端 items.source.url用于获取答案的网站 URL。 字符串 桌面端 items.source.title包含答案的网站标题。 字符串 桌面端 items.source.url_shown显示在答案下方的简短 URL。 字符串 桌面端和移动端 items.question相关问题部分中的问题。 字符串 桌面端和移动端 pos_overall表示“相关问题”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_overall表示 Item 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_overall表示 Recipes 结果在 SERP 中的位置。 整数 桌面端和移动端
### 视频
该 `videos` Google 搜索结果页中的功能会展示与用户搜索查询相关的精选视频内容，包括缩略图、标题和来源信息。
键（results.videos） 说明 类型 布局 items包含视频部分所有结果的列表。 数组 桌面端和移动端 items.pos视频在列表中的位置。 整数 桌面端和移动端 items.url视频链接。 字符串 桌面端和移动端 items.title视频标题。 字符串 桌面端和移动端 items.author视频上传所在个人资料的名称。 字符串 桌面端和移动端 items.source托管该视频的平台名称。 字符串 桌面端和移动端 pos_overall表示 Videos 结果在 SERP 中的位置。 整数 桌面端和移动端
### 精选摘要
该 `featured_snippet` 是一种独特的 Google 搜索结果，它会在页面链接之前显示一段简短的页面摘要。这些高亮结果会突出显示在自然搜索结果顶部，为用户快速获取相关信息。
键（results.featured_snippet） 说明 类型 布局 url摘录页面描述的来源网站 URL。 字符串 桌面端和移动端 desc包含特定搜索结果描述的摘要。 字符串 桌面端和移动端 title摘录页面描述的文章名称。 字符串 桌面端和移动端 url_shownSERP 中可见的、包含精选摘要的网站 URL。 字符串 桌面端和移动端 pos_overall表示 Featured Snippet 结果在 SERP 中的位置。 整数 桌面端和移动端
### 酒店
Google `hotels` 是一项直接在搜索结果中展示酒店信息的功能。当用户在 Google 上搜索酒店或住宿相关查询时，搜索引擎可能会在结果页顶部显示专门的酒店模块，方便且醒目地概览相关选项。
键（results.hotels） 说明 类型 布局 date_to退房日期。 字符串 桌面端 results包含酒店所有详情的列表。 数组 桌面端 results.price酒店价格。 字符串 桌面端 results.title酒店名称。 字符串 桌面端 results.description显示在酒店名称下方的酒店简短描述。 字符串 桌面端 date_from入住日期。 字符串 桌面端 pos_overall表示 Hotels 结果在 SERP 中的位置。 整数 桌面端
### 航班
该 `flights` 该功能展示一个包含与相关搜索查询对应的已整理航班选项的模块，方便用户直接在搜索结果中比较不同选项。
键（results.flights） 说明 类型 布局 到到达机场。 字符串 桌面端和移动端 从出发机场。 字符串 桌面端和移动端 date_to到达日期。 字符串 桌面端和移动端 results带有各自详情的精选航班列表。 数组 桌面端和移动端 results.url指向 Google Flights 页面、列出某一家航空公司所有航班的链接。 字符串 桌面端和移动端 results.type航班类型。 字符串 桌面端 results.price航班价格。 字符串 桌面端和移动端 results.airline承运航空公司名称。 字符串 桌面端和移动端 results.duration航班时长。 字符串 桌面端和移动端 date_from起飞日期。 字符串 桌面端和移动端 pos_overall表示 Flights 结果在 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, 律师事务所",
"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_overall表示 Local Service Ads 结果在 SERP 中的位置。 整数 桌面端
### 应用
该 `apps` SERP 功能会根据用户查询显示相关应用，并提供价格、评分等关键信息。该功能为应用开发者和发布者提供了一个宝贵的平台，可直接在 Google 搜索结果页提升其移动应用的曝光度和互动量。
键（results.apps） 说明 类型 布局 id应用在可用应用商店中的 ID。 字符串 移动端 url包含 SERP 中该应用完整信息的应用商店 URL。 字符串 移动端 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表示某项在所有讨论和论坛结果中的位置的指示符。 整数 桌面端 items.url指向特定论坛帖子或讨论线程的 URL 链接 字符串 桌面端 items.title论坛帖子或讨论主题的标题或主标题 字符串 桌面端 items.source承载论坛或讨论的来源 字符串 桌面端 items.timeframe论坛帖子或讨论的时间范围或日期 字符串 桌面端 items.comments_count论坛帖子或讨论线程收到的评论或回复数量 字符串 桌面端 pos_overall表示“讨论和论坛”SERP 功能在 SERP 中的位置。 整数 桌面端
#### **JSON 示例**
```json
...
"discussions_and_forums": {
"items": [
{
"pos": 1,
"url": "https://www.reddit.com/r/webscraping/comments/y4v5ws/free_http_proxy/",
"title": "免费 HTTP 代理？ : r/webscraping - Reddit",
"source": "Reddit",
"timeframe": "1y",
"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:
```
GET https://developers.oxylabs.io/api-targets/cn/sou-suo-yin-qing/google/search/search.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
