---
title: "Fetch business details directly from Google Maps"
method: GET
path: "/maps/business-details"
tags: ["Google Maps"]
---

# Fetch business details directly from Google Maps

`GET /maps/business-details`

## Request

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

## Query parameters

- `business_id` string, required
- `hl` string, nullable
- `gl` string, nullable

## Response `200`

- object[]
  - `business_id` string, required
  - `google_id` string, required
  - `place_id` string, nullable, required
  - `google_mid` string, nullable, required
  - `phone_number` string, nullable, required
  - `name` string, required
  - `latitude` number, nullable, required
  - `longitude` number, nullable, required
  - `full_address` string, nullable, required
  - `review_count` integer, required
  - `rating` number, nullable, required
  - `timezone` string, nullable, required
  - `opening_status` string, nullable, required
  - `working_hours` object[], nullable, required
    - `day` string, required
    - `hours` string, required
  - `website` string, nullable, required
  - `tld` string, nullable, required
  - `verified` boolean, required
  - `place_link` string, required
  - `cid` string, nullable, required
  - `reviews_link` string, nullable, required
  - `web_reviews_url` string, nullable, required
  - `owner_id` string, nullable, required
  - `owner_link` string, nullable, required
  - `owner_name` string, nullable, required
  - `booking_link` string, nullable, required
  - `reservations_link` string, nullable, required
  - `business_status` string, nullable, required
  - `type` string, nullable, required
  - `subtypes` string[], required
  - `subtype_gcids` string[], required
  - `photos_sample` object[], required
    - `photo_id` string, nullable, required
    - `photo_url` string, required
    - `photo_url_large` string, nullable, required
    - `video_thumbnail_url` string, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `type` string, required
    - `photo_datetime_utc` string, nullable, required
    - `photo_timestamp` integer, nullable, required
  - `global_plus_code` string, nullable, required
  - `compound_plus_code` string, nullable, required
  - `reviews_per_rating` unknown, required
  - `reviews_removed_due_to_defamation` object, nullable, required
    - `message` string, nullable, required
    - `title` string, nullable, required
    - `help_link` string, nullable, required
    - `help_link_text` string, nullable, required
    - `summary` string, nullable, required
    - `is_active` boolean, nullable, required
    - `range_bucket` integer, nullable, required
    - `language` string, nullable, required
    - `minimum_removed_review_count` integer, nullable, required
    - `maximum_removed_review_count` integer, nullable, required
    - `count_text` string, nullable, required
  - `photo_count` integer, required
  - `about` unknown[], required
    - unknown
  - `address` string, nullable, required
  - `menu_link` string, nullable, required
  - `order_link` string, nullable, required
  - `price_level` string, nullable, required
  - `district` string, nullable, required
  - `street_address` string, nullable, required
  - `city` string, nullable, required
  - `zipcode` string, nullable, required
  - `state` string, nullable, required
  - `country` string, nullable, required
  - `emails_and_contacts` unknown[], required
    - unknown
  - `share_link` string, nullable, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `404`: Google Maps did not return a business profile for the supplied business_id. This can happen when the ID is stale, the place is no longer public, or the ID points to a profile Google cannot serve in the requested locale.
- `422`: The business_id parameter is required and must be a Google Maps google_id in 0x...:0x... format or a place_id starting with ChIJ. Locale parameters must use valid hl and gl codes.
- `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)