Business Details

Retrieve comprehensive details for a specific business using its unique business ID. Returns all available information including name, address, contact details, hours, ratings, categories, and more. The business ID can be obtained from any search endpoint.

HTTP Request

1
GET /business_details

Parameters

Parameter	Type	Required	Default	Description
`business_id`	string	Yes	—	Unique business identifier in hex format (`0x...:0x...`) or place ID
`language`	string	No	`"en"`	Language code for the response
`country`	string	No	`"us"`	Country code for regional context

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
{
  "status": true,
  "request_id": "7acc52d9-e389-95de-dadc-3a45ed0c",
  "data": {
    "google_id": "0x89c6c62958fb0109:0xcd8fd007dc1d6b01",
    "google_mid": "/m/06lbq9",
    "place_id": "ChIJCQH7WCnGxokRAWsd3AfQj80",
    "cid": "14812286431621114625",
    "name": "Reading Terminal Market",
    "status": "OPEN",
    "description": "Home to 70+ family-owned, small businesses...",
    "address": "1136 Arch St, Philadelphia, PA 19107",
    "full_address": "Reading Terminal Market, 1136 Arch St, Philadelphia, PA 19107",
    "detailed_address": {
      "district": "Center City East",
      "street": "1136 Arch St",
      "city": "Philadelphia",
      "state": "PA",
      "zip_code": "19107",
      "country": "United States"
    },
    "main_category": "Market",
    "categories": ["Market", "Grocery store"],
    "latitude": 39.9531593,
    "longitude": -75.1590984,
    "global_plus_code": "87F6XR3R+79",
    "compound_plus_code": "XR3R+79 Philadelphia, Pennsylvania",
    "time_zone": "America/New_York",
    "owner_name": "Reading Terminal Market (Owner)",
    "owner_id": "113494116662531000229",
    "owner_profile_url": "https://www.google.com/maps/contrib/113494116662531000229",
    "place_url": "https://www.google.com/maps/preview/place/Reading+Terminal+Market...",
    "working_hours": {
      "Monday": { "working_hours": ["8 AM-6 PM"], "usual_working_hours": [] }
    },
    "popular_times": {
      "Monday": [{ "hour_of_day": 6, "time_label": "6 AM", "popularity_percent": 0 }]
    },
    "website_url": "https://readingterminalmarket.org/",
    "website_domain": "readingterminalmarket.org",
    "about": [{ "id": "service_options", "name": "Service options", "options": [] }],
    "about_descriptions": ["Historic hub for eclectic foods & goods"],
    "competitors": [{ "google_id": "0x0:0xe9cf80dd84e810e0", "name": "Kauffman's Dutch Market" }],
    "rating": 4.7,
    "reviews_count": 46154,
    "reviews_per_rating": { "1": 266, "2": 344, "3": 1613, "4": 7670, "5": 36261 },
    "reviews_top_terms": [{ "term": "cheesesteak", "number": 666 }],
    "reviews_sample": [],
    "photos_sample": [],
    "featured_photo": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmcmS33...",
    "phone": "(215) 922-2317",
    "full_phone": "+12159222317",
    "can_claim": false,
    "price_range": null
  },
  "request_params": {
    "business_id": "0x89c6c62958fb0109:0xcd8fd007dc1d6b01"
  }
}

Response Fields

data is a single object, not an array. It carries 51 fields; the most useful are listed here.

Field	Type	Description
`status`	boolean	`true` when the request succeeded
`request_id`	string	Unique identifier for this request
`data`	object	Full business details
`data.google_id`	string	Business identifier in hex format
`data.google_mid`	string	Google knowledge-graph machine ID
`data.place_id`	string	Google place ID
`data.cid`	string	Numeric customer ID used in Maps URLs
`data.name`	string	Business name
`data.status`	string	Operating status, e.g. `"OPEN"`
`data.description`	string/null	Business description from the listing
`data.address`	string	Short address
`data.full_address`	string	Full address, prefixed with the business name
`data.detailed_address`	object	`street`, `district`, `city`, `state`, `zip_code`, `country`
`data.main_category`	string	Primary category
`data.categories`	array	All categories
`data.latitude`	number	Business latitude
`data.longitude`	number	Business longitude
`data.global_plus_code`	string	Global Plus Code
`data.compound_plus_code`	string	Local Plus Code with place name
`data.time_zone`	string	IANA time zone
`data.owner_name`	string/null	Listing owner’s display name
`data.owner_id`	string/null	Owner’s Google profile ID
`data.owner_profile_url`	string/null	Link to the owner’s profile
`data.place_url`	string	Google Maps place URL
`data.working_hours`	object	Per-weekday `working_hours` and `usual_working_hours` arrays
`data.popular_times`	object/null	Per-weekday array of `hour_of_day`, `time_label`, `popularity_percent`
`data.website_url`	string/null	Website URL
`data.website_domain`	string/null	Website domain only
`data.menu_url`	string/null	Menu link, for food listings
`data.reservation_url`	string/null	Booking or ordering link
`data.order_online_url`	string/null	Online ordering link
`data.about`	array	Structured attribute groups (service options, accessibility, amenities)
`data.about_descriptions`	array	Short editorial descriptions
`data.competitors`	array	Similar nearby businesses, each with `google_id` and `name`
`data.rating`	number	Average rating (1-5)
`data.reviews_count`	integer	Total number of reviews
`data.reviews_per_rating`	object	Review counts keyed by star rating `"1"`-`"5"`
`data.reviews_top_terms`	array	Most frequent review terms, each with `term` and `number`
`data.reviews_sample`	array	A handful of recent reviews. Use Business Reviews for the full history
`data.photos_sample`	array	A handful of photos. Use Business Photos for all of them
`data.user_suggestions`	array	Pending user-submitted edits
`data.featured_photo`	string/null	Main photo URL
`data.phone`	string/null	Phone in local format
`data.full_phone`	string/null	Phone in E.164 format
`data.can_claim`	boolean	Whether the listing is unclaimed
`data.price_range`	string/null	Price range, when Google shows one
`data.price_breakdown`	object/null	Structured pricing, when available

Hotel listings additionally carry hotel_about, hotel_descriptions, and hotel_stars. questions_and_answers_sample and posts_sample are present in the schema but commonly null.

Notes

reviews_per_rating gives you the full star distribution in one request, without paginating reviews.
competitors returns the “People also search for” businesses, each with a google_id you can feed straight back into this endpoint.
reviews_sample and photos_sample are previews only. For complete data use the dedicated reviews and photos endpoints.

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import requests

url = "https://google-maps-extractor2.p.rapidapi.com/business_details"

querystring = {
    "business_id": "0x89c259a9aeb1c6b5:0x35b1cfbc380cb867",
    "language": "en",
    "country": "us"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()

biz = data["data"]
print(f"{biz['name']}")
print(f"Rating: {biz['rating']} ({biz['reviews_count']} reviews)")
print(f"Address: {biz['address']}")
print(f"Phone: {biz['phone']}")
print(f"Website: {biz['website']}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
const url = "https://google-maps-extractor2.p.rapidapi.com/business_details";

const params = new URLSearchParams({
  business_id: "0x89c259a9aeb1c6b5:0x35b1cfbc380cb867",
  language: "en",
  country: "us",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com",
  },
});

const data = await response.json();
const biz = data.data;

console.log(biz.name);
console.log(`Rating: ${biz.rating} (${biz.reviews_count} reviews)`);
console.log(`Address: ${biz.address}`);
console.log(`Phone: ${biz.phone}`);
console.log(`Website: ${biz.website}`);

1
2
3
4
5
6
curl -G "https://google-maps-extractor2.p.rapidapi.com/business_details" \
  --data-urlencode "business_id=0x89c259a9aeb1c6b5:0x35b1cfbc380cb867" \
  --data-urlencode "language=en" \
  --data-urlencode "country=us" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: google-maps-extractor2.p.rapidapi.com"

Search Nearby — Find businesses to get their IDs
Business Reviews — Get reviews for this business
Business Photos — Get photos for this business