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

Gallery tabs for one business A single GET returns the list of photo categories a business has, with 12 entries in the test call, so a client knows the gallery layout before it requests any photo.
Name and hash on every entry Each category carries a human-readable name and a hash. The documentation points to that hash as the category value for the business photos endpoint.
Business-specific category names The sampled restaurant listed dish tabs such as Chimichanga, Cobb salad and Margarita next to generic ones like Menu, Vibe, By owner and Videos, so categories differ per place.
One required input Only business_id is required, and it takes a Google Maps ID, CID or place ID. The test call used the 0x...:0x... form, and the other two formats follow the endpoint documentation.
Optional locale parameters country and lang can be added to the request. The test call omitted both, so how they affect the returned category names was not verified.
Lightweight discovery call The response holds only name and hash pairs inside the status, request_id, data and request_params envelope, which keeps it small enough to cache per business.

Live API Demo

GET /api/project/google-maps-extractor/business-photos-categories

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-photos-categories?key=<API_KEY>&business_id=0x863f7e635e3bc389%3A0xfd99687094131d65'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →