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

# Simple Search

`GET /maps/simple-search`

## Request

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

Search for businesses on Google Maps with a simple query.

## Query parameters

- `query` string, required
- `hl` string, nullable
- `gl` string, nullable
- `google_domain` string, nullable
- `limit` integer, nullable
- `page` integer, nullable
- `fields` string, nullable

## Response `200`

- object
  - `items` object[], required
    - `name` string, nullable, required
    - `price_level` string, nullable, required
    - `price_level_text` string, nullable, required
    - `review_count` integer, nullable, required
    - `rating` number, nullable, required
    - `website` string, nullable, required
    - `domain` string, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `business_id` string, nullable, required
    - `subtypes` string[], nullable, required
    - `district` string, nullable, required
    - `full_address` string, nullable, required
    - `timezone` string, nullable, required
    - `short_description` string, nullable, required
    - `full_description` string, nullable, required
    - `owner_id` string, nullable, required
    - `owner_name` string, nullable, required
    - `owner_link` string, nullable, required
    - `order_link` string, nullable, required
    - `google_mid` string, nullable, required
    - `type` string, nullable, required
    - `phone_numbers` string[], required
    - `place_id` string, nullable, required
    - `photos_sample` object[], required
      - `photo_id` string, nullable, required
      - `photo_url` string, nullable, required
      - `photo_url_large` string, nullable, required
      - `video_thumbnail_url` string, nullable, required
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `type` string, required
    - `opening_hours` object[], nullable, required
      - `day` string, nullable, required
      - `hours` string[], required
      - `date` string, nullable, required
      - `special_day` string, nullable, required
    - `current_status` string, nullable, required
  - `pagination` object, required
    - `current_page` integer, required
    - `limit` integer, nullable, required
    - `total_results` integer, required
    - `has_more` boolean, 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/2f4af6143d10?raw)