---
title: "Search Google Places"
method: GET
path: "/v1/places/search"
tags: ["Google Places"]
---

# Search Google Places

`GET /v1/places/search`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/places/search`
- Auth: API key in header `X-API-Key`

Search Google Maps places (local businesses, restaurants, hotels, shops and points of interest) by free-text query. Returns name, address, phone, website, rating, review count, opening hours, coordinates, and a sample of photos for each result. Optionally bias results by latitude, longitude and zoom level; `lat` and `lng` must be sent together. Each page returns up to 10 places and is billed as one request, up to 20 pages per call.

**Price:** $0.01 per page. **Free tier:** 20 requests/month.

## Query parameters

- `query` string, required
- `pages` integer
- `limit` integer
- `lat` number
- `lng` number
- `zoom` integer
- `country` string
- `language` string

## Response `200`

Successful response

- SearchPlacesResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `places` object[], nullable
    - `place_id` string, nullable
    - `name` string, nullable
    - `type` string, nullable
    - `subtypes` string[], nullable
    - `phone_number` string, nullable
    - `website` string, nullable
    - `domain` string, nullable
    - `rating` number, nullable
    - `review_count` number, nullable
    - `reviews_per_rating` object, nullable
      - `1` number, nullable
      - `2` number, nullable
      - `3` number, nullable
      - `4` number, nullable
      - `5` number, nullable
    - `price_level` string, nullable
    - `verified` boolean, nullable
    - `business_status` string, nullable
    - `opening_status` string, nullable
    - `working_hours` object, nullable
      - `Monday` string[], nullable
      - `Sunday` string[], nullable
    - `opening_date` unknown
    - `address` string, nullable
    - `street_address` string, nullable
    - `district` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zipcode` string, nullable
    - `country` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `timezone` string, nullable
    - `summary` string, nullable
    - `about` object, nullable
      - `summary` string, nullable
      - `details` object, nullable
        - `Accessibility` object, nullable
          - `Wheelchair accessible entrance` boolean, nullable
          - `Wheelchair accessible parking lot` boolean, nullable
          - `Wheelchair accessible seating` boolean, nullable
    - `photo_count` number, nullable
    - `photos_sample` object[], nullable
      - `photo_id` string, nullable
      - `type` string, nullable
      - `photo_url` string, nullable
      - `photo_url_large` string, nullable
      - `video_thumbnail_url` unknown
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `photo_datetime_utc` string, nullable
      - `photo_timestamp` number, nullable
    - `place_link` string, nullable
    - `reviews_link` string, nullable
    - `booking_link` string, nullable
    - `reservations_link` string, nullable
    - `order_link` string, nullable
    - `owner_name` string, nullable
    - `owner_link` string, nullable
    - `cid` string, nullable
  - `count` number, nullable
  - `query` string, nullable
  - `pages` number, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving Places data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)