> ## 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://brightdata.com/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 产品，并以 JSON、NDJSON、JSON Lines 或 CSV 格式返回结果。

## 响应内容示例

Bright Data Google Scraper API 返回的单条 Google 地图地点记录。可在[快速开始](/cn/products/scrapers/google/quickstart)中亲自发送该请求。

```json theme={null}
{
  "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
  "name": "Empire State Building",
  "address": "20 W 34th St., New York, NY 10001",
  "category": "Observation deck",
  "rating": 4.7,
  "reviews_count": 98500,
  "phone": "+1 212-736-3100",
  "website": "https://www.esbnyc.com/",
  "latitude": 40.7484405,
  "longitude": -73.9856644
}
```

## 支持的数据类型

<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/products/scrapers/concepts/sync-vs-async)。

## 功能与限制

| 功能               | 详情                                                                                                                                                                                                                            |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **输出格式**         | JSON、NDJSON、CSV                                                                                                                                                                                                               |
| **同步请求最大 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/delivery-options)） |
| **计费**           | 按成功记录计费（[查看价格](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">
    cURL、Python 和 Node.js 的每个端点完整代码示例。
  </Card>

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