Fast Maps Search

Bright Data offers a fast SERP service for Google Maps, available to selected enterprise customers only. This service responds with a compact JSON to power real-time applications that need local business listings and place data. To gain access, please contact your Bright Data account manager.

Google Maps endpoints

Google Maps Fast SERP supports two response types depending on the URL you target:

Maps search results — a list of places matching a search query, returning an organic array
Place detail page — a single place record, returning a place object

Both endpoints require the x-unblock-data-format: parsed_light request header and the brd_json=1 URL parameter. Omitting either will result in an unexpected response format.

Fast Maps Search Request

Fast SERP for Google Maps works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

Maps search results

curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/search/coffee+shops+new+york/?hl=en&gl=us&brd_json=1"

Place detail page

curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en&gl=us&brd_json=1"

Response Format

The response is one of two shapes depending on the targeted URL: a search results page returns an organic array; a place detail page returns a place object. Both use the same OrganicMapsItem structure.

`organic` array / `place` object

Both the items in organic and the place object share the following fields:

Field	Type	Required	Description
`global_rank`	integer	Yes	Rank position of the result on the page
`title`	string	No	Name of the place
`address`	string	No	Full address of the place
`phone`	string	No	Phone number of the place
`link`	string	No	URL to the place’s website
`map_link`	string	No	URL to the place on Google Maps
`map_id`	string	No	Google Maps place identifier
`map_id_encoded`	string	No	Encoded version of the Google Maps place identifier
`description`	string	No	Short description of the place
`price`	string	No	Price range indicator, e.g. `"$$"`
`rating`	number	No	Average customer rating
`reviews_cnt`	number	No	Total number of customer reviews
`latitude`	number	No	Latitude coordinate of the place
`longitude`	number	No	Longitude coordinate of the place
`image`	string	No	Primary image URL
`original_image`	string	No	Original full-resolution image URL
`thumbnail`	string	No	Thumbnail image URL
`open_hours`	object	No	Opening hours keyed by day, e.g. `"Monday": "9am–5pm"`
`category`	array	No	List of place categories (see below)
`images`	array	No	List of place images (see below)
`menu_images`	array	No	List of menu images (see below)
`tags`	array	No	List of place attribute tags (see below)
`reviews`	array	No	List of customer reviews (see below)

`category` items

Field	Type	Required	Description
`id`	string	Yes	Category identifier
`title`	string	Yes	Full category name
`title_short`	string	No	Shortened category name

`images` and `menu_images` items

Field	Type	Required	Description
`image`	string	Yes	Image URL
`image_width`	integer	No	Displayed image width in pixels
`image_height`	integer	No	Displayed image height in pixels
`original_width`	integer	No	Original image width in pixels
`original_height`	integer	No	Original image height in pixels

`tags` items

Field	Type	Required	Description
`group_id`	string	Yes	Identifier of the tag group
`group_title`	string	Yes	Display name of the tag group
`key_id`	string	Yes	Identifier of the tag key
`key_title`	string	Yes	Display name of the tag key
`value`	number	No	Numeric value associated with the tag
`value_title`	string	No	Display label for the tag value
`value_title_short`	string	No	Shortened display label for the tag value

`reviews` items

Field	Type	Description
`author`	string	Name of the reviewer
`avatar`	string	URL of the reviewer’s profile image
`author_reviews_cnt`	number	Total number of reviews written by this author
`author_photos_cnt`	number	Total number of photos uploaded by this author
`rating`	number	Rating given in this review
`text`	string	Review text content
`timestamp_added`	string	Date/time the review was posted
`timestamp_edited`	string	Date/time the review was last edited
`link`	string	URL to the review
`source`	string	Platform source of the review
`source_logo`	string	URL of the source platform’s logo
`images`	array of strings	List of image URLs attached to the review
`response_text`	string	Owner’s reply to the review
`response_timestamp_added`	string	Date/time the owner’s reply was posted
`response_timestamp_edited`	string	Date/time the owner’s reply was last edited

Example Response

Maps search results

{
  "organic": [
    {
      "global_rank": 1,
      "title": "Example Coffee Co.",
      "address": "123 Main St, New York, NY 10001",
      "phone": "+1 212-555-0100",
      "link": "https://www.example-coffee.com",
      "map_link": "https://www.google.com/maps/place/example-coffee",
      "map_id": "ChIJexample1234",
      "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
      "price": "$$",
      "rating": 4.7,
      "reviews_cnt": 1280,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
      "open_hours": {
        "Monday": "7am–7pm",
        "Tuesday": "7am–7pm",
        "Wednesday": "7am–7pm",
        "Thursday": "7am–7pm",
        "Friday": "7am–8pm",
        "Saturday": "8am–8pm",
        "Sunday": "9am–6pm"
      },
      "category": [
        { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
      ],
      "tags": [
        {
          "group_id": "service_options",
          "group_title": "Service options",
          "key_id": "dine_in",
          "key_title": "Dine-in",
          "value": 1,
          "value_title": "Available",
          "value_title_short": "Yes"
        }
      ],
      "reviews": [
        {
          "author": "Jane D.",
          "avatar": "https://example.com/avatars/jane.jpg",
          "author_reviews_cnt": 42,
          "author_photos_cnt": 15,
          "rating": 5,
          "text": "Best espresso in the city, hands down.",
          "timestamp_added": "2025-03-10T09:00:00Z",
          "source": "Google",
          "source_logo": "https://www.google.com/images/google-logo.png",
          "response_text": "Thank you so much, Jane! See you soon.",
          "response_timestamp_added": "2025-03-11T10:00:00Z"
        }
      ]
    }
  ]
}

Place detail page

{
  "place": {
    "global_rank": 1,
    "title": "Example Coffee Co.",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1 212-555-0100",
    "link": "https://www.example-coffee.com",
    "map_link": "https://www.google.com/maps/place/example-coffee",
    "map_id": "ChIJexample1234",
    "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
    "price": "$$",
    "rating": 4.7,
    "reviews_cnt": 1280,
    "latitude": 40.7128,
    "longitude": -74.0060,
    "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
    "images": [
      {
        "image": "https://www.example-coffee.com/images/interior.jpg",
        "image_width": 800,
        "image_height": 600,
        "original_width": 1600,
        "original_height": 1200
      }
    ],
    "open_hours": {
      "Monday": "7am–7pm",
      "Friday": "7am–8pm",
      "Saturday": "8am–8pm",
      "Sunday": "9am–6pm"
    },
    "category": [
      { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
    ]
  }
}

Response schema: https://api.brightdata.com/data_schemas/fast_serp/google_search_maps.schema.json

Supported parameters

`gl`

Two-letter country code used to define the country of search

`hl`

Two-letter language code used to define the page languages

Introduction

Product Guides

Google Maps endpoints

Fast Maps Search Request

Maps search results

Place detail page

Response Format

`organic` array / `place` object

`category` items

`images` and `menu_images` items

`tags` items

`reviews` items

Example Response

Maps search results

Place detail page

Supported parameters

`gl`

`hl`

Introduction

Product Guides

​Google Maps endpoints

​Fast Maps Search Request

​Maps search results

​Place detail page

​Response Format

​organic array / place object

​category items

​images and menu_images items

​tags items

​reviews items

​Example Response

​Maps search results

​Place detail page

​Supported parameters

​gl

​hl

Google Maps endpoints

Fast Maps Search Request

Maps search results

Place detail page

Response Format

`organic` array / `place` object

`category` items

`images` and `menu_images` items

`tags` items

`reviews` items

Example Response

Maps search results

Place detail page

Supported parameters

`gl`

`hl`