Google Scraper API endpoints - Bright Data Docs

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 with an active API key
Completed the Quickstart

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.

The /scrape endpoint is built for real-time, single-URL requests. Bright Data recommends 20 inputs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 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 or have it pushed to you with webhook delivery.

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/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'

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())

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);

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

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
`profile_pic_url`	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
`fid_location`	text
`category`	text	The category or type of the business
`cid`	text	Customer ID

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

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

​Prerequisites

​Request structure

​Google Maps, Collect by URL

​Which output fields does the Google Maps scraper return?

​Google Maps, Discover by CID

​Google Maps, Discover by place_id

​Google Maps, Discover by location

​Google Maps Reviews, Collect by URL

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

​Google Shopping, Collect by URL

​Which output fields does the Google Shopping scraper return?

​Google Shopping, Discover by keyword

​Google Shopping Products Search US, Collect by URL

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

​Google SERP 100 Results, Collect by URL

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

​Google AI Mode Search, Collect by URL

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

​Google Flights, Collect by URL

​Which output fields does the Google Flights scraper return?

​Google Flights, Discover by input filters

​Google Hotels, Collect by URL

​Which output fields does the Google Hotels scraper return?

​Google Hotels, Discover by filter URL

​Google Hotels, Discover by search

​Related

Async batch requests

API reference

Prerequisites

Request structure

Google Maps, Collect by URL

Which output fields does the Google Maps scraper return?

Google Maps, Discover by CID

Google Maps, Discover by place_id

Google Maps, Discover by location

Google Maps Reviews, Collect by URL

Which output fields does the Google Maps reviews scraper return?

Google Shopping, Collect by URL

Which output fields does the Google Shopping scraper return?

Google Shopping, Discover by keyword

Google Shopping Products Search US, Collect by URL

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

Google SERP 100 Results, Collect by URL

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

Google AI Mode Search, Collect by URL

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

Google Flights, Collect by URL

Which output fields does the Google Flights scraper return?

Google Flights, Discover by input filters

Google Hotels, Collect by URL

Which output fields does the Google Hotels scraper return?

Google Hotels, Discover by filter URL

Google Hotels, Discover by search

Related