Skip to main content
This tutorial walks you through sending a synchronous request to each Bright Data Google Scraper API endpoint. By the end, you’ll have working examples for Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

Prerequisites

Request structure

Every synchronous request follows the same pattern:
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.
Synchronous requests support up to 20 inputs and have a 1-minute timeout. If the request takes longer, the API automatically returns a snapshot_id instead. See async requests.

Google Maps — Collect by URL

Scrape a specific Google Maps place by its URL. Dataset ID: gd_m8ebnr0q2qlklc02fz
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/Empire+State+Building"}]'
Full schema

Google Maps — Discover by CID

Find a Google Maps place using its Customer ID (CID) value. Dataset ID: gd_m8ebnr0q2qlklc02fz
cURL
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 '[{"CID": "14408248692727049506"}]'
Full schema

Google Maps — Discover by place_id

Find a place using its Google Maps place ID. Dataset ID: gd_m8ebnr0q2qlklc02fz
cURL
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 '[{"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'
Full schema

Google Maps — Discover by location

Find places near a geographic point using latitude, longitude, zoom level and a search keyword. Dataset ID: gd_m8ebnr0q2qlklc02fz
cURL
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 '[{"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}]'
Full schema

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
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/Empire+State+Building", "days_limit": 30}]'
Full schema

Google Shopping — Collect by URL

Scrape a Google Shopping product page by its URL, with optional country targeting. Dataset ID: gd_ltppk50q18kdw67omz
cURL
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/shopping/product/12345", "country": "US"}]'
Full schema

Google Shopping — Discover by keyword

Find Google Shopping products matching a search term, with optional country targeting. Dataset ID: gd_ltppk50q18kdw67omz
cURL
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 '[{"keyword": "wireless headphones", "country": "US"}]'
Full schema

Google Shopping Products Search US — Collect by URL

US-focused Google Shopping search result scraper. Dataset ID: gd_m31f2k0d2m1bah4f3b
cURL
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

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
cURL
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

Google AI Mode Search — Collect by URL

Scrape answers and citations from Google’s AI Mode Search. Dataset ID: gd_mcswdt6z2elth3zqr2
cURL
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"
  }]'
Full schema

Google Flights — Collect by URL

Scrape flight options, pricing and itineraries from a Google Flights URL. Dataset ID: gd_mhng7wen1rw0a3gvpf
cURL
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

Google Flights — Discover by input filters

Find flights by origin, destination, dates and passenger counts. Dataset ID: gd_mhng7wen1rw0a3gvpf
cURL
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 '[{
    "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"
  }]'
Full schema

Google Hotels — Collect by URL

Scrape a Google Hotels listing by its URL, with optional country targeting. Dataset ID: gd_mg3gjfmg12tc2n5d4d
cURL
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

Google Hotels — Discover by filter URL

Discover hotels from a filtered Google Hotels URL. Dataset ID: gd_mg3gjfmg12tc2n5d4d
cURL
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 '[{
    "url": "https://www.google.com/travel/hotels/New+York?...",
    "country": "US",
    "currency": "USD"
  }]'
Full schema Discover hotels by destination, dates and guest count. Dataset ID: gd_mg3gjfmg12tc2n5d4d
cURL
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 '[{
    "search_term": "New York",
    "check_in_date": "2026-06-15",
    "check_out_date": "2026-06-18",
    "guest_number": 2,
    "country": "US",
    "currency": "USD"
  }]'
Full schema

Next steps

Async batch requests

Scrape thousands of records or run discovery jobs in a single async request.

API reference

Full endpoint specs, parameters and response schemas.