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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/google-maps-extractor/business-details 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'
Query Result
Use Cases
- Enriching a shortlisted lead list with phone, website and category data only for the businesses that passed an earlier filter
- Verifying a venue's address, open or closed status and coordinates before publishing it in a directory or marketplace listing
- Monthly refresh of stored listings to catch changed contact details, categories or status
- Competitor watch that diffs a rival's rating, review count and listing fields between two dates
- Filling CRM records or a store-locator database from a business ID taken from a search or autocomplete row
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.