Fetch the full Google Maps listing record for one business by ID, CID or place ID.

View all Google Maps Data API: Business Search, Reviews & Photos endpoints →

Returns the detail record for a single Google Maps business. Send the required business_id as a Google Maps ID (0x...:0x... form), a numeric CID or a ChIJ... place ID, and optionally set country and language. The response is a JSON object with status (true on success), request_id, a data object and the echoed request_params. In a live test call (a hotel looked up by a 0x...:0x... ID), data included the identifiers google_id, google_mid, place_id and cid; name, status, address, full_address and a detailed_address breakdown (district, street, city, zip_code, state, country); main_category, category_id and categories; latitude, longitude, global_plus_code, compound_plus_code and time_zone; owner_name, owner_id and place_url; website_url, website_domain, phone and full_phone; and rating, reviews_count, reviews_per_rating, reviews_top_terms, reviews_sample, photos_sample and featured_photo. For that hotel, working_hours, popular_times, menu_url, reservation_url, order_online_url, price_range, competitors and posts_sample were null, while hotel_about, hotel_descriptions and hotel_stars were filled, so expect category-dependent fields to be null or absent for other business types. The CID and place ID input forms come from the endpoint documentation and were not used in the test call. The response example published with the endpoint is an empty object, so the fields above come from the live test call only.

API Features

Full listing record in one call A single GET returns the identity, address, category, contact, rating and sample fields of one Google Maps business inside a data object.
Three accepted ID formats business_id takes a Google Maps ID (0x...:0x...), a numeric CID or a ChIJ... place ID, so IDs from different sources can be used as they are.
Structured address and geo fields Returns address, full_address and a detailed_address object with district, street, city, zip_code, state and country, plus latitude, longitude, plus codes and time_zone.
Contact and web presence fields Includes phone, full_phone, website_url and website_domain, along with menu_url, reservation_url and order_online_url, which are null when a listing has none.
Rating and review snapshot Carries rating, reviews_count, a reviews_per_rating histogram, reviews_top_terms and a small reviews_sample for a quick reputation check.
Category-specific blocks Hotel listings add hotel_about, hotel_descriptions and hotel_stars, while fields that do not apply to a business type come back null.

Live API Demo

GET /api/project/google-maps-extractor/business-details

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-details?key=<API_KEY>&business_id=0x89c25990830633d3%3A0x3ec3c57e2a2fe39a'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Which ID formats can I send as business_id?

The documentation lists a Google Maps ID such as 0x89c2585500e85589:0x18f39d1f8ee2a312, a numeric CID such as 3132777853886366741, and a place ID such as ChIJiVXoAFVYwokREqPijh-d8xg. The live test call used the 0x...:0x... form; the other two were not exercised.

Where do I get a business ID?

Search and autocomplete rows return google_id and place_id values in the same formats. The details response also echoes google_id, google_mid, place_id and cid for the business you asked about.

Why are some fields null, such as working_hours or price_range?

In the test call, a hotel listing returned null for working_hours, popular_times, menu_url, reservation_url, order_online_url, price_range, competitors and posts_sample. Fields depend on the business type and on what the listing publishes, so handle null values in your parser.

Does this endpoint return all reviews and photos?

No. reviews_sample and photos_sample are small samples (five reviews and four photos in the test call). Use the business reviews and business photos endpoints for full, cursor-paged lists.

What do country and language do?

Both are optional code parameters for the query, for example us and en; accepted values are not enumerated in the documentation. Note that this endpoint spells the second one language, while the autocomplete and photos endpoints use lang.

What does the response envelope look like?

A JSON object with status (true on success), request_id, a data object holding the business fields and request_params echoing the business_id that was sent.

Related operations

Guides

View Subscription Plans →