List photos and videos for a Google Maps business with category filtering and cursor paging.

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

Returns a page of photos and videos attached to one Google Maps business. Send the required business_id (Google Maps ID, CID or place ID) and optionally category (a category hash from the business photo categories endpoint), country, lang, limit (default 20) and next_page_token. The response is a JSON object with status (true on success), request_id, a data array, next_token for the following page and the echoed request_params. In a live test call with limit=5, data held 14 items (10 of type photo and 4 of type video), each with id, url, type, label, max_size (width and height), aspect_ratio, video_url, video_duration_ms, user_name, user_id, user_profile_url, user_avatar and upload_date_text; label is null for some items, and video_url and video_duration_ms are filled only for videos. Because the test call returned more items than the requested limit, treat limit as a page-size hint and trim on the client if you need an exact count. To fetch the next page, send the returned next_token value as next_page_token. The response example published with the endpoint is an empty object, so the fields above come from the live test call only.

API Features

Photos and videos in one list Each item has a type of photo or video, with video_url and video_duration_ms filled only for videos, so one response can feed both image and clip galleries.
Category-scoped galleries Pass a category hash from the business photo categories endpoint to pull just one slice of a listing, such as a single photo group, instead of the mixed default set.
Cursor pagination with next_token Each response returns a next_token cursor; send it back as next_page_token to continue through a large gallery.
Uploader attribution fields Items carry user_name, user_id, user_profile_url, user_avatar and upload_date_text, which helps with credit lines and recency checks.
Image dimensions for layout max_size gives width and height and aspect_ratio is precomputed, so a grid or masonry layout can reserve space before images load.
Per-item labels Many photos carry a short label (for example a dish or drink name in the test call), and the label is null when none is available.

Live API Demo

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

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

Use Cases

Frequently asked questions

How do I get the next page of photos?

Read next_token from the response and send it as the next_page_token parameter on the next request, keeping the same business_id and category. Note that the response field is named next_token while the request parameter is next_page_token.

Where do I get the category value?

category is a hash taken from the business photo categories endpoint (/business_photos_categories) for the same business. The live test call left it empty and still returned a mixed set of photos and videos.

Does limit cap the number of items returned?

The documentation says it returns a maximum of limit photos, but the test call with limit=5 returned 14 items, so use limit as a page-size hint and trim on the client if you need an exact count. The default is 20.

Can the list include videos?

Yes. In the test call, 4 of 14 items had type video. For those, video_url and video_duration_ms are filled; for photos they are null.

What does each photo item contain?

id, url, type, label, max_size as a width and height pair, aspect_ratio, video_url, video_duration_ms, user_name, user_id, user_profile_url, user_avatar and upload_date_text (for example "2 years ago").

Which business_id formats work?

The documentation lists a Google Maps ID (0x...:0x...), a numeric CID or a ChIJ... place ID. The test call used the 0x...:0x... form.

Related operations

Guides

View Subscription Plans →