> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google 爬虫 API

> 使用 Bright Data Google 爬虫 API 从 Google 地图、购物、SERP、航班、酒店等提取结构化数据。

发送 Google URL 或关键词，获得结构化 JSON。Bright Data Google 爬虫 API 覆盖地图、购物、搜索结果、AI Mode 搜索、航班和酒店，使用一致的请求和响应结构。

<Tip>
  初次使用 Bright Data？[创建免费账户](https://www.bright.cn/products/web-scraper/google?hs_signup=1\&utm_source=docs)，即可**每月获得 5,000 个免费积分**，无需信用卡。这相当于最多 **5,000 条 Google 记录**，可供你开始抓取。请参阅[免费套餐](/cn/general/account/billing-and-pricing/free-tier)。
</Tip>

## 工作原理

你将一个或多个 Google URL、关键词或结构化输入发送到 Bright Data Google 爬虫 API。Bright Data 处理代理、验证码和解析，然后返回干净的 JSON。

```
你的应用  -->  Bright Data API  -->  结构化 JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

所有请求都使用 `dataset_id` 指定 Google 产品，并以 NDJSON（默认）、JSON、JSON lines、CSV 和 Parquet 格式返回结果。见[输出格式](/cn/products/scrapers/scrapers-library/data-delivery#支持哪些输出格式)。

## 响应内容示例

Bright Data Google Scraper API 于 2026 年 9 月 6 日返回的单条 Google 地图地点记录（已裁剪为所示字段）。可在[快速开始](/cn/products/scrapers/google/quickstart)中亲自发送该请求。

```json theme={null}
{
  "place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ",
  "name": "The***s",
  "address": "5155 Peachtree Pkwy NW, Peachtree Corners, GA 30092, United States",
  "category": "Shopping mall",
  "rating": 4.6,
  "reviews_count": 5066,
  "url": "https://www.google.com/maps/place/The+Forum+Peachtree+Corners/@33.9808771,-84.2175823,17z/data=!3m1!4b1!4m6!3m5!1s0x88f5a1a57295954b:0xc4368b9aac3c4d1d!8m2!3...",
  "country": "United States",
  "description": "Outdoor mall with a European feel & a collection of upscale chains & boutiques, plus restaurants.",
  "main_image": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmZ8YyHocxqtXw40FHlo2WbKu1zLCxcFQrAWkwM9zj_O76dd_9Mpl-H9rjqS7GjsehkGXvpMA4xDse4qi1ysYEJTzwMpwLOqB3BGwkGap8c1-..."
}
```

## 支持的数据类型

<CardGroup cols={2}>
  <Card title="Google 地图" icon="map-location-dot" href="/cn/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    地点、评论、评分、照片和社区统计。按 URL 收集，或按 CID、place ID 或地理位置发现。
  </Card>

  <Card title="Google 地图评论" icon="star" href="/cn/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url">
    完整评论文本、评分和评论者元数据，可按可配置的回溯窗口过滤。
  </Card>

  <Card title="Google 购物" icon="bag-shopping" href="/cn/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url">
    产品列表、定价、商家和规格。按 URL 收集，或按关键词发现。
  </Card>

  <Card title="Google 购物搜索 US" icon="store" href="/cn/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url">
    以美国为重点的产品搜索结果，扩展的商家和定价覆盖。
  </Card>

  <Card title="Google SERP 100 结果" icon="magnifying-glass" href="/cn/api-reference/scrapers/search-engines-apis/google-serp-100-collect-by-url">
    每次查询最多 100 个自然结果，支持语言、设备和地理定位。
  </Card>

  <Card title="Google AI Mode 搜索" icon="robot" href="/cn/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url">
    来自 Google AI 驱动搜索体验的答案和引用。
  </Card>

  <Card title="Google 航班" icon="plane" href="/cn/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url">
    航班选项、定价和行程。按 URL 收集，或按路线和日期发现。
  </Card>

  <Card title="Google 酒店" icon="bed" href="/cn/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url">
    酒店价格、可用性和设施。按 URL、过滤器 URL 或搜索参数收集。
  </Card>
</CardGroup>

## 数据集 ID

每个 Google 产品使用自己的 `dataset_id`。在每个请求上将 ID 作为查询参数传递。

| 产品 | 数据集 ID |
| :- | :- |
| Google 地图完整信息 | `gd_m8ebnr0q2qlklc02fz` |
| Google 地图评论 | `gd_luzfs1dn2oa0teb81` |
| Google 购物 | `gd_ltppk50q18kdw67omz` |
| Google 购物产品搜索 US | `gd_m31f2k0d2m1bah4f3b` |
| Google SERP 100 结果 | `gd_mfz5x93lmsjjjylob` |
| Google AI Mode 搜索 | `gd_mcswdt6z2elth3zqr2` |
| Google 航班 | `gd_mhng7wen1rw0a3gvpf` |
| Google 酒店 | `gd_mg3gjfmg12tc2n5d4d` |

## 请求方式

Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。

| 方式 | 端点 | 适用场景 |
| :- | :- | :- |
| **同步** | `/scrape` | 实时查询，最多 20 个 URL |
| **异步** | [`/trigger`](/cn/products/scrapers/scrapers-library/async-requests) | 批量任务、20 个及以上 URL、生产环境管道 |

详见[了解同步与异步请求](/cn/concepts/sync-vs-async)。

两个端点都接受带 `input` 数组的对象，可附加 `limit_per_input` 和 `custom_output_fields`，在 `/trigger` 上还可附加 `deliver` 配置。也接受由输入组成的纯 JSON 数组，本页示例使用此格式。详见[请求体](/cn/api-reference/scrapers/synchronous-requests#请求体)。

## 功能与限制

| 功能 | 详情 |
| :- | :- |
| **输出格式** | NDJSON（默认）、JSON、JSON lines、CSV 和 Parquet（[各格式适用范围](/cn/products/scrapers/scrapers-library/data-delivery#支持哪些输出格式)） |
| **同步请求最大 URL 数** | 20 |
| **异步请求最大 URL 数** | 无限制，每个任务最多 1 GB 输入 |
| **数据新鲜度** | 实时（按需抓取） |
| **投递方式** | API 下载、[webhook](/cn/products/scrapers/scrapers-library/data-delivery)、[Amazon S3](/cn/products/scrapers/scrapers-library/data-delivery)、Snowflake、Azure、GCS（[全部目标](/cn/products/scrapers/scrapers-library/data-delivery)） |
| **计费** | 按成功记录计费（[查看价格](https://www.bright.cn/pricing/web-scraper)） |

## 下一步

<CardGroup cols={3}>
  <Card title="快速开始" icon="rocket" href="/cn/products/scrapers/google/quickstart">
    5 分钟内爬取你的第一个 Google 地图地点。
  </Card>

  <Card title="端点" icon="bolt" href="/cn/products/scrapers/google/send-first-request">
    每个端点一个请求，附实际抓取的响应。
  </Card>

  <Card title="API 参考" icon="code" href="/cn/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    端点规范、参数和响应架构。
  </Card>
</CardGroup>
