> ## 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.

# Fast SERP maps search

> Use Bright Data Fast SERP (31 languages) for Google Maps via the native proxy interface. Receive compact JSON Maps results suited for real-time applications.

Use Bright Data's Fast SERP service to retrieve compact Maps search results in real time via a native proxy interface.

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

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --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: using Place ID

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --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"
```

### Place details page: using Map Link

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e379c3784bfe3b:0x839c689710299cfc?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. Search results use `OrganicMapsSearchItem`; place detail pages use `OrganicMapsPlaceItem`. The two are identical except for the shape of the `reviews` array.

### `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 (maps search results)

Search results carry a single short review snippet per place, with three fields only.

| Field    | Type   | Description                         |
| -------- | ------ | ----------------------------------- |
| `text`   | string | Review text snippet                 |
| `avatar` | string | URL of the reviewer's profile image |
| `link`   | string | URL to the review on Google Maps    |

<Note>
  On search results pages Google exposes only a snippet - no author, rating, timestamps, or images. Use the place detail endpoint for full review objects.
</Note>

### `reviews` items (place detail page)

| 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

```text theme={null}
{
  "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": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
      "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "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": [
        {
          "text": "I love that they have vegan options and I enjoyed their iced coffee too.",
          "avatar": "https://ssl.gstatic.com/local/servicebusiness/default_user.png",
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xKNlJXWklUR1JHYVZwVVFUZDNlbFYxTUhSTVZYYxAB!2m1!1s0x0:0x2c2119fb675d62e7!3m1!1s2@1"
        }
      ]
    }
  ]
}
```

### Maps Place detail page

```text theme={null}
{
  "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": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
    "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "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" }
    ],
    "reviews": [
      {
        "text": "Excellent coffee and bakery treats in a clean, modern space. The almond croissant was buttery and flaky, with a nice level of sweetness.",
        "author": "Sviatlana.B",
        "avatar": "https://lh3.googleusercontent.com/a-/ALV-UjUavxkeqq5_Po5gMMQ5svtrPEqox1tWnoBiOD0jDpBU1ymA7jE=s120-c-rp-mo-ba12-br100",
        "author_reviews_cnt": 76,
        "author_photos_cnt": 490,
        "rating": 5,
        "timestamp_added": "2026-05-11T00:19:15.594Z",
        "timestamp_edited": "2026-05-12T10:18:13.857Z",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "images": [
          "https://lh3.googleusercontent.com/grass-cs/ACvplmNq1ASznw8ls76jo9sg-GcIDwywKkOM_XdonRCWZjaLUisyUKXS90lzQl7l_E8Iw4Uwk-Eu4LpuQtwe0FhSdQ4h8wlln887K7RSRqWxxvoF91nxtne-oeW3oBWTe8DkCJZHrOd_R2eUv6g=k-no"
        ],
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21oeloxQnFlbE5aTVY5RVlYcFFWa2xmTTNjd2JYYxAB!2m1!1s0x0:0x143482a9c81bf22b!3m1!1s2@1"
      }
    ]
  }
}
```

Response schema, Maps search results: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_search.schema.json)

Response schema, place detail page: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_place.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_place.schema.json)

## Supported parameters

| Parameter     | Description                                | Example                | Notes                                                                             |
| ------------- | ------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------- |
| `gl`          | Two-letter country code for search country | `gl=us`                |                                                                                   |
| `hl`          | Two-letter language code for page language | `hl=en`                |                                                                                   |
| `brd_json`    | **Required.**`1` = parsed JSON             | `brd_json=1`           |                                                                                   |
| `search term` | Search query term embedded in URL          | `coffee+shops+near+me` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |

***