---
title: "Google Place Details"
method: GET
path: "/v1/places/details"
tags: ["Google Places"]
---

# Google Place Details

`GET /v1/places/details`

## Request

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

Get full details for a single Google Maps place by `place_id`. Returns everything Places Search returns, plus Plus Codes, a menu link, and an `emails_and_contacts` scrape of the place's official website (emails, phone numbers and links to Facebook, Instagram, LinkedIn, Twitter/X, TikTok, YouTube, Pinterest, Snapchat, Yelp, and GitHub). The `emails_and_contacts` block is always present: `emails` and `phone_numbers` come back as empty arrays and each social link as `null` when nothing is found.

**Price:** $0.003 per request. **Free tier:** 50 requests/month.

## Query parameters

- `place_id` string, required
- `country` string
- `language` string

## Response `200`

Successful response

- PlaceDetailsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `place` 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
    - `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
    - `global_plus_code` string, nullable
    - `compound_plus_code` string, nullable
    - `menu_link` unknown
    - `emails_and_contacts` object, nullable
      - `emails` unknown[], nullable
        - unknown
      - `phone_numbers` string[], nullable
      - `facebook` unknown
      - `instagram` string, nullable
      - `linkedin` unknown
      - `twitter` unknown
      - `tiktok` unknown
      - `youtube` unknown
      - `pinterest` unknown
      - `snapchat` unknown
      - `yelp` unknown
      - `github` unknown

## 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`).
- `404`: Place not found
- `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)
