---
title: "Advanced Search"
method: GET
path: "/maps/advanced-search"
tags: ["Google Maps"]
---

# Advanced Search

`GET /maps/advanced-search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/maps/advanced-search`
- Auth: API key in header `X-API-KEY`

Search for businesses on Google Maps with advanced filtering options.

## Query parameters

- `query` string, required
- `lon` number, nullable
- `lat` number, nullable
- `zoom` number, required
- `limit` number, nullable
- `page` number, nullable
- `hl` string, nullable
- `gl` string, nullable
- `google_domain` string, nullable
- `fields` string, nullable

## Response `200`

- object
  - `items` object[], required
    - `name` string, required
    - `business_id` string, nullable, required
    - `place_id` string, nullable, required
    - `rating` number, nullable, required
    - `review_count` integer, nullable, required
    - `price_level` string, nullable, required
    - `website` string, nullable, required
    - `domain` string, nullable, required
    - `phone_numbers` string[], required
    - `full_address` string, nullable, required
    - `district` string, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `subtypes` string[], nullable, required
    - `type` string, nullable, required
    - `short_description` string, nullable, required
    - `opening_hours` object[], nullable, required
      - `day` string, nullable, required
      - `hours` string[], required
      - `date` string, nullable, required
    - `current_status` string, nullable, required
    - `photos_sample` object[], required
      - `photo_id` string, required
      - `photo_url` string, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: The query, zoom, coordinates, pagination, field projection, locale, or domain parameters failed validation.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)