List the photo categories (gallery tabs) of a Google Maps business, each with a name and a hash.
View all Google Maps Data API: Business Search, Reviews & Photos endpoints →Returns the photo categories that a Google Maps business has in its gallery. Send the required business_id (Google Maps ID such as 0x...:0x..., a numeric CID or a ChIJ... place ID) and optionally country and lang. The response is a JSON object with status (true on success), request_id, a data array and the echoed request_params. In a live test call with only business_id, data held 12 entries, each with a name and a hash. The names seen were All, Menu, Food & drink, Vibe, five dish-specific tabs (Chimichanga, Cobb salad, Quesadilla, Egg roll, Margarita), By owner, Street View & 360 degrees and Videos, so the list is specific to the business and is not a fixed set. The endpoint documentation describes the hash as the value for the category parameter of the business photos endpoint; the test call did not chain the two requests. This endpoint returns categories only, never photos. The response example published with the endpoint is an empty object (and a validation error shape with detail entries for 422), 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-photos-categories API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-photos-categories?key=<API_KEY>&business_id=0x863f7e635e3bc389%3A0xfd99687094131d65'
Query Result
Use Cases
- Checking which gallery tabs a venue actually has before requesting photos, so empty category calls are never made
- Rendering category filter chips on a venue page from the returned category names
- Deciding whether a restaurant has a Menu category worth sending to an OCR job that extracts dish names and prices
- Auditing client listings that lack categories such as Videos, Vibe or By owner that nearby competitors have
- Building a one-time name-to-hash map per business and reusing it for every later photos request
Frequently asked questions
What does the photo categories endpoint return?
A JSON object with status, request_id, a data array and the echoed request_params. In a live test call, data held 12 entries, each with a name and a hash. It lists categories only and does not return any photo URLs.
Which parameters are required?
Only business_id is required; the sample form uses 0x863f7e635e3bc389:0xfd99687094131d65. country and lang are optional and their accepted values are not enumerated in the endpoint documentation.
Which business_id formats can I send?
The documentation lists a Google Maps ID (0x...:0x...), a numeric CID or a ChIJ... place ID. The test call used the Google Maps ID form only, so try your own CID or place ID values on a sample business first.
How do I use a category hash to get photos?
The documentation describes the hash as the category value of the business photos endpoint, so send it there with the same business_id. The test call for this endpoint did not chain the two requests, so verify the flow with your own business.
Is the category list the same for every business?
No. The sampled restaurant had generic tabs (All, Menu, Food & drink, Vibe, By owner, Videos) plus dish-named tabs, which suggests the list is built per business. Only one business was probed, so do not assume a fixed set.
What happens when business_id is missing or invalid?
The endpoint documentation shows a 422 validation error with a detail array of loc, msg and type entries. That shape comes from the published documentation, not from the test call, and no failing request was probed.