> ## 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 Scraper API endpoints

> Send sync requests to every Bright Data Google Scraper API endpoint, with copy-paste examples for Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

This guide shows you how to send a synchronous request to each Bright Data Google Scraper API endpoint. It covers Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/google?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](https://docs.brightdata.com/products/scrapers/google/quickstart.md)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.google.com/..."}]
```

The only things that change between endpoints are the `dataset_id`, the optional discovery query parameters and the input shape.

> [!NOTE]
>
> The `/scrape` endpoint is built for real-time, single-URL requests. The endpoint returns the data in the response when collection finishes within 1 minute. Bright Data recommends one input per request, because more inputs are less likely to finish within 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](https://docs.brightdata.com/products/scrapers/scrapers-library/async-requests.md) or have it pushed to you with [webhook delivery](https://docs.brightdata.com/products/scrapers/scrapers-library/data-delivery.md).

## Google Maps, Collect by URL

Scrape a specific Google Maps place by its URL.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}],
)

print(response.json())
```

```javascript Node.js theme={null}
const response = await fetch(
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ" }
    ]),
  }
);

const data = await response.json();
console.log(data);
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url.md)

### Which output fields does the Google Maps scraper return?

The Google Maps scraper (`gd_m8ebnr0q2qlklc02fz`, `collect_by_url`) returns 39 output fields.

> [accordion] Output fields (39)
>
> | Field | Type | Description |
> | - | - | - |
> | `place_id` | text | Unique identifier for the place on Google Maps |
> | `url` | url | URL pointing to the business on Google Maps |
> | `country` | text | The country where the business is located |
> | `name` | text | The name of the business |
> | `category` | text | The category or type of the business |
> | `address` | text | The physical address of the business |
> | `description` | text | A detailed description of the business |
> | `business_details` | array | A list of structured key-value attributes providing additional details about the business (e.g., accessibility, payment options, amenities) |
> | `open_hours` | object | Operating hours of the business for each day of the week |
> | `reviews_count` | number | The total number of reviews for the business |
> | `rating` | number | The average rating given by customers |
> | `main_image` | url | URL or identifier of the main image associated with the business |
> | `lat` | number | Latitude coordinate of the business location |
> | `lon` | number | Longitude coordinate of the business location |
> | `services_provided` | array | List of services provided by the business |
> | `hotel_amenities` | array | Amenities offered by a hotel-type business |
> | `hotel_star_ratings` | text | Star ratings for hotels |
> | `open_website` | text | A link or indication of whether the business has a website that can be visited |
> | `phone_number` | text | The contact phone number for the business |
> | `permanently_closed` | boolean | Indicates whether the business has been permanently closed |
> | `photos_and_videos` | array | A list of URLs pointing to photos and videos associated with the business |
> | `people_also_search` | array | A list of related businesses that users frequently searched for alongside this business |
> | `web_results` | array | A list of web search results related to the business, including external links and previews |
> | `reservation_link` | url | A URL to an external reservation or booking platform for the business |
> | `questions_answers` | array | A list of community questions and their answers about the business |
> | `top_reviews` | array | A list of the most prominent customer reviews for the business, including reviewer details and ratings |
> | `reviews_snippets` | array | A list of short review snippets displayed for the business, each including the reviewer's name, image, and a text excerpt |
> | `directory_categories` | array | A list of directory categories associated with the business, including the category name and count of businesses within each |
> | `directory_locations` | array | A list of other business locations from the same chain or directory, with ratings, review counts, and category details |
> | `popular_times` | array | A list of popular visiting times for the business, broken down by day of the week and hour, with relative busyness percentages |
> | `cid_location` | text | The Google Customer ID (CID) associated with the specific location of the business |
> | `is_claimed` | boolean | Indicates whether the business owner has claimed and verified this Google Maps listing |
> | `fid_location` | text | The Feature ID (FID) associated with the business location, used internally by Google Maps |
> | `review_distribution` | object | The distribution of customer reviews broken down by star rating (1 through 5) |
> | `all_categories` | array | A complete list of all business categories assigned to the business on Google Maps |
> | `country_code` | text | The ISO 3166-1 alpha-2 country code of the country where the business is located |
> | `cid` | text | The Google Customer ID (CID) uniquely identifying the business on Google Maps |
> | `temporarily_closed` | boolean | Indicates whether the business is temporarily closed |
> | `category_index` | object | Indexing metadata for the business category, including Google Category IDs and Knowledge Graph entity references |

Machine-readable version with the input schema: [`/scrapers/gd_m8ebnr0q2qlklc02fz.json`](https://docs.brightdata.com/scrapers/gd_m8ebnr0q2qlklc02fz.json)

## Google Maps, Discover by CID

Find a Google Maps place using its Customer ID (CID) value.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=cid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"CID": "14138641576607108381"}], "limit_per_input": 10}'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-cid.md)

## Google Maps, Discover by place\_id

Find a place using its Google Maps place ID.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=place_id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}], "limit_per_input": 10}'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-place-id.md)

## Google Maps, Discover by location

Find places near a geographic point using latitude, longitude, zoom level and a search keyword.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}], "limit_per_input": 10}'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-location.md)

## Google Maps Reviews, Collect by URL

Scrape reviews for a Google Maps place, optionally limiting to reviews posted within the last N days.

**Dataset ID:** `gd_luzfs1dn2oa0teb81`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_luzfs1dn2oa0teb81&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ", "days_limit": 30}]'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "gd_luzfs1dn2oa0teb81", "format": "json"},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ", "days_limit": 30}],
)

print(response.json())
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url.md)

### Which output fields does the Google Maps reviews scraper return?

The Google Maps reviews scraper (`gd_luzfs1dn2oa0teb81`, `collect_by_url`) returns 26 output fields.

> [accordion] Output fields (26)
>
> | Field | Type | Description |
> | - | - | - |
> | `url` | url | Link to the Google Maps page of the place |
> | `place_id` | text | Unique identifier for the place |
> | `place_name` | text | Name of the place |
> | `country` | text | Country of the place |
> | `address` | text | Full address of the place |
> | `review_id` | text | Unique identifier for the review |
> | `reviewer_name` | text | Name of the reviewer |
> | `reviews_by_reviewer` | number | Total reviews by the reviewer |
> | `photos_by_reviewer` | text | Total photos by the reviewer |
> | `reviewer_url` | url | Link to the reviewer's profile |
> | `local_guide` | boolean | Indicates if the reviewer is a Local Guide |
> | `review_rating` | number | Star rating given |
> | `review` | text | Text of the review |
> | `review_date` | date | Date of the review |
> | `number_of_likes` | number | Likes given to the review |
> | `response_of_owner` | text | Owner's response to the review |
> | `response_date` | date | Date of owner's response |
> | `photos` | array | Photos included with the review |
> | `review_details` | array | review details |
> | `profile_pic_url` | url | profile picture url |
> | `place_general_rating` | number | The general rating of the place |
> | `overall_place_riviews` | number | The number of overall reviews given to a place by users |
> | `questions_answers` | array | questions answers |
> | `fid_location` | text | fid location |
> | `category` | text | The category or type of the business |
> | `cid` | text | Customer ID |

Machine-readable version with the input schema: [`/scrapers/gd_luzfs1dn2oa0teb81.json`](https://docs.brightdata.com/scrapers/gd_luzfs1dn2oa0teb81.json)

## Google Shopping, Collect by URL

Scrape a Google Shopping product page by its URL, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/search?ibp=oshop&q=JLab+Studio+2+Wireless+Headphones&prds=imageDocid:5923580954857402377,catalogid:13340055750063076763,productid:10724334734735144389,headlineOfferDocid:3470074678539476160,gpcid:9062160688233355186,mid:576462881232491926,pvt:hg,rds:PC_9062160688233355186|PROD_PC_9062160688233355186&pvorigin=25&hl=en&gl=us&shem=damc,pvflt,shrtsdl&shndl=37&udm=28&source=sh/x/prdct/hdr/m1/1", "country": "US"}]'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url.md)

### Which output fields does the Google Shopping scraper return?

The Google Shopping scraper (`gd_ltppk50q18kdw67omz`, `collect_by_url`) returns 43 output fields.

> [accordion] Output fields (43)
>
> | Field | Type | Description |
> | - | - | - |
> | `url` | url | The URL or link to the product |
> | `product_id` | text | Unique identifier for the product |
> | `title` | text | Title or name of the product |
> | `product_description` | array | Description of the product |
> | `rating` | number | Average rating of the product |
> | `reviews_count` | number | Number of ratings or reviews for the product |
> | `images` | array | Images of the product |
> | `variations` | array | Product variations |
> | `tags` | array | Tags associated with the product |
> | `product_details` | text | Additional details about the product |
> | `amount_of_stars` | object | Distribution of star ratings |
> | `seller_name` | text | Name of the seller or vendor |
> | `delivery_price` | text | Price for delivery. |
> | `item_price` | text | Price of the item |
> | `total_price` | text | Total price including all costs |
> | `currency` | text | Currency code in which the product prices are denominated (e.g., USD, EUR, GBP) |
> | `product_specifications` | array | Specifications of the product |
> | `related_items` | array | Related items |
> | `country` | text | Country code or name where the product is being sold or where the listing was scraped from |
> | `buying_options` | array | The buying options of the product across different sellers, each with seller name, URL, price, and currency |
> | `variant_id` | text | Variant identifier, derived from product\_id (no separate variant ID in Google Shopping) |
> | `description` | text | Product description text, derived from product\_description array joined into single text, or from product\_details |
> | `product_category` | text | Product category path as text (not available in Google Shopping) |
> | `category_tree` | array | NAI-formatted category tree with name/url objects (not available in Google Shopping) |
> | `brand` | text | Brand name, extracted from product\_specifications where specification\_name='Brand' |
> | `image_url` | text | Main product image URL, derived from first element of images array |
> | `price` | price | Product price, parsed from item\_price text (remove \$ and extra text) |
> | `sale_price` | price | Sale/discounted price (not available in Google Shopping - no separate sale price) |
> | `availability` | text | Product availability status: default to 'in\_stock' for listed products |
> | `availability_date` | text | Expected delivery/availability date, extracted from delivery\_price text if present |
> | `group_id` | text | Group identifier for product variants, derived from product\_id |
> | `listing_has_variations` | boolean | Indicates if the product listing has multiple variations, derived from variations array |
> | `variant_attributes` | array | Current variant attributes for this product, derived from variations with variation\_name→name, variation\_value→value mapping |
> | `nai_variants` | array | variant data grouped by variant type, restructured from variations array |
> | `store_name` | text | Name of the store/seller, derived from seller\_name |
> | `seller_url` | text | URL to the seller's product page, extracted from first seller\_url in buying\_options array |
> | `seller_privacy_policy` | text | URL to the seller's privacy policy |
> | `seller_tos` | text | URL to the seller's terms of service |
> | `return_window` | number | Number of days allowed for returns, parsed from return\_policy text |
> | `target_countries` | array | List of country codes where product is available, derived from country wrapped in array |
> | `store_country` | text | Country code where the store is located, derived from country |
> | `category_urls` | array | List of category URLs (not available in Google Shopping) |
> | `reviews` | array | Review entries from customers for the product |

Machine-readable version with the input schema: [`/scrapers/gd_ltppk50q18kdw67omz.json`](https://docs.brightdata.com/scrapers/gd_ltppk50q18kdw67omz.json)

## Google Shopping, Discover by keyword

Find Google Shopping products matching a search term, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"keyword": "wireless headphones", "country": "US"}], "limit_per_input": 10}'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-discover-by-keyword.md)

## Google Shopping Products Search US, Collect by URL

US-focused Google Shopping search result scraper.

**Dataset ID:** `gd_m31f2k0d2m1bah4f3b`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m31f2k0d2m1bah4f3b&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/search?tbm=shop&q=wireless+headphones"}]'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url.md)

### Which output fields does the Google Shopping products search US scraper return?

The Google Shopping products search US scraper (`gd_m31f2k0d2m1bah4f3b`, `collect_by_url`) returns 15 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | The URL of the product listing page |
| `product_id` | text | Unique identifier for the product |
| `title` | text | The product title |
| `final_price` | number | The final price after discounts or promotions |
| `initial_price` | number | The original price before discounts |
| `currency` | text | The currency of the product’s price |
| `rating` | number | The average customer rating of the product |
| `reviews_count` | number | The total number of reviews the product has |
| `shipping` | text | Shipping details like cost and delivery time |
| `image` | url | URL of the product image |
| `tags` | array | A list of keywords or categories related to the product |
| `small_business` | boolean | Whether the product is sold by a small business |
| `page` | number | The page number the product appears on |
| `location_on_page` | number | The product's position on the page (e.g., 1st, 2nd) |
| `id` | text | The product ID |

Machine-readable version with the input schema: [`/scrapers/gd_m31f2k0d2m1bah4f3b.json`](https://docs.brightdata.com/scrapers/gd_m31f2k0d2m1bah4f3b.json)

## Google SERP 100 Results, Collect by URL

Scrape up to 100 organic results from a Google Search URL with fine-grained targeting.

**Dataset ID:** `gd_mfz5x93lmsjjjylob`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mfz5x93lmsjjjylob&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?q=best+coffee+nyc",
    "keyword": "best coffee nyc",
    "tbm": "",
    "language": "en",
    "uule": "",
    "brd_mobile": "",
    "tbs": "",
    "nfpr": "",
    "index": ""
  }]'
```

[Full schema](https://docs.brightdata.com/products/serp-api/get-top-100-google-results.md)

### Which output fields does the Google SERP 100 results scraper return?

The Google SERP 100 results scraper (`gd_mfz5x93lmsjjjylob`, `collect_by_url`) returns 18 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | URL |
| `keyword` | text | keyword used in search |
| `general` | object | general |
| `related` | array | related |
| `pagination` | array | pagination |
| `organic` | array | organic |
| `people_also_ask` | array | people\_also\_ask |
| `navigation` | array | navigation |
| `language` | text | Input language |
| `country` | country | Input country |
| `aio_citations` | array | aio\_citations |
| `page_html` | text | HTML of first page |
| `aio_text` | text | aio\_text |
| `index` | text | input index |
| `local_pack` | array | local\_pack |
| `aio_markdown` | html2markdown | aio\_markdown |
| `aio_citations_displayed` | array | Boolean array of flags for aio\_citations |
| `aio_sources_displayed_count` | number | Number of distinct citations actually rendered by google search AI |

Machine-readable version with the input schema: [`/scrapers/gd_mfz5x93lmsjjjylob.json`](https://docs.brightdata.com/scrapers/gd_mfz5x93lmsjjjylob.json)

## Google AI Mode Search, Collect by URL

Scrape answers and citations from Google's AI Mode Search.

**Dataset ID:** `gd_mcswdt6z2elth3zqr2`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mcswdt6z2elth3zqr2&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
    "prompt": "how to train for a marathon",
    "country": "US"
  }]'
```

To get the answer in another language, add `hl` with a Google language code. This request sends an English prompt and returns the answer in German:

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mcswdt6z2elth3zqr2&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
    "prompt": "how to train for a marathon",
    "country": "DE",
    "hl": "de"
  }]'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url.md)

### Which output fields does the Google AI Mode Search scraper return?

The Google AI Mode Search scraper (`gd_mcswdt6z2elth3zqr2`, `collect_by_url`) returns 13 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | Google AI's URL |
| `prompt` | text | The input prompt |
| `answer_html` | text | The answer of Google AI search |
| `answer_text` | text | The answer of Google AI search |
| `links_attached` | array | Links attached to answer |
| `citations` | array | citations |
| `index` | number | The index column lets you assign a unique ID to each crawl request for easy tracking. |
| `country` | country | Country to search from |
| `answer_text_markdown` | html2markdown | Answer text in markdown format |
| `shopping` | array | Shopping data from the AI mode |
| `answer_text_raw` | text | answer\_text\_raw: Original answer text as extracted, without trimming or whitespace normalization (may include leading/trailing spaces and newline characters). |
| `ads` | array | ads |
| `citations_mapping` | array | Array mapping the AI overview text to their corresponding citations. |

Machine-readable version with the input schema: [`/scrapers/gd_mcswdt6z2elth3zqr2.json`](https://docs.brightdata.com/scrapers/gd_mcswdt6z2elth3zqr2.json)

## Google Flights, Collect by URL

Scrape flight options, pricing and itineraries from a Google Flights URL.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/flights?tfs=..."}]'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url.md)

### Which output fields does the Google Flights scraper return?

The Google Flights scraper (`gd_mhng7wen1rw0a3gvpf`, `collect_by_url`) returns 6 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | \[Metadata] The exact Google Flights booking URL from the discovery collector (includes tfs). |
| `itinerary_id` | text | \[Metadata] Stable unique ID for this itinerary (e.g., hash of segments + pax/cabin or the tfs token) |
| `search` | object | Search widget values |
| `pricing` | object | Pricing deatils |
| `providers` | array | Booking options for this itinerary |
| `legs` | array | Trip legs (1=one way, 2=round trip, 3+=multi‑city) |

Machine-readable version with the input schema: [`/scrapers/gd_mhng7wen1rw0a3gvpf.json`](https://docs.brightdata.com/scrapers/gd_mhng7wen1rw0a3gvpf.json)

## Google Flights, Discover by input filters

Find flights by origin, destination, dates and passenger counts.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json&type=discover_new&discover_by=input_filters" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "origin": "JFK",
      "destination": "LAX",
      "departure": "2026-06-15",
      "return": "2026-06-22",
      "trip_type": "round_trip",
      "adults": 1,
      "children": 0,
      "infants_in_seat": 0,
      "infants_on_lap": 0,
      "cabin": "economy"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-flights-discover-by-input-filters.md)

## Google Hotels, Collect by URL

Scrape a Google Hotels listing by its URL, with optional country targeting.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/hotels/entity/...", "country": "US"}]'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url.md)

### Which output fields does the Google Hotels scraper return?

The Google Hotels scraper (`gd_mg3gjfmg12tc2n5d4d`, `collect_by_url`) returns 31 output fields.

> [accordion] Output fields (31)
>
> | Field | Type | Description |
> | - | - | - |
> | `url` | url | The URL of the hotel listing on Google. |
> | `hotel_id` | text | hotel unique id |
> | `hotel_name` | text | The official name of the hotel. |
> | `rating` | number | The overall rating of the hotel. |
> | `review_count` | text | The total number of reviews. |
> | `star_classification` | number | The star classification of the hotel. |
> | `address` | text | The full street address of the hotel. |
> | `phone_number` | text | The contact phone number for the hotel. |
> | `photos` | array | Collection of hotel photos with captions. |
> | `check_in_date` | date | Selected check-in date for price queries. |
> | `check_out_date` | date | Selected check-out date for price queries. |
> | `guest_number` | number | Number of guests for the booking query. |
> | `booking_options` | array | Available booking options from different platforms. |
> | `price_trend` | text | Current price trend information. |
> | `similar_hotels` | array | List of similar hotels with comparison information. |
> | `nearby_places` | array | List of nearby attractions and points of interest. |
> | `neighborhood_info` | object | Information about the hotel's neighborhood. |
> | `google_review_summary` | object | Summary of Google reviews including rating distribution. |
> | `third_party_reviews` | array | Reviews from third-party travel sites. |
> | `about_hotel` | text | Detailed description about the hotel, its location, and nearby attractions. |
> | `check_in_time` | text | Hotel check-in time. |
> | `check_out_time` | text | Hotel check-out time. |
> | `popular_amenities` | array | List of popular hotel amenities. |
> | `official_website` | url | Official hotel website URL. |
> | `alternative_hotels` | array | List of alternative hotels that users also viewed. |
> | `vacation_rentals_nearby` | array | Nearby vacation rental alternatives. |
> | `popular_hotels_in_city` | array | Popular hotels in the same city. |
> | `search_term` | text | search\_term |
> | `currency` | text | Currency |
> | `lat` | number | The latitude coordinate of the hotel |
> | `long` | number | The longitude coordinate of the hotel |

Machine-readable version with the input schema: [`/scrapers/gd_mg3gjfmg12tc2n5d4d.json`](https://docs.brightdata.com/scrapers/gd_mg3gjfmg12tc2n5d4d.json)

## Google Hotels, Discover by filter URL

Discover hotels from a filtered Google Hotels URL.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=filter_url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "url": "https://www.google.com/travel/hotels/New+York?...",
      "country": "US",
      "currency": "USD"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-filter-url.md)

## Google Hotels, Discover by search

Discover hotels by destination, dates and guest count.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "search_term": "New York",
      "check_in_date": "2026-06-15",
      "check_out_date": "2026-06-18",
      "guest_number": 2,
      "country": "US",
      "currency": "USD"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-search.md)

## Related

> [card] [Async batch requests](https://docs.brightdata.com/products/scrapers/scrapers-library/async-requests.md)
>
> Scrape thousands of records or run discovery jobs in a single async request.

> [card] [API reference](https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url.md)
>
> Full endpoint specs, parameters and response schemas.
