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
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 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'
Query Result
Use Cases
- Pulling menu-category photos into an OCR pipeline that extracts dish names and prices
- Building venue galleries for travel or restaurant pages, paging with next_token until the gallery is complete or capped
- Comparing visual coverage between a client and its competitors, category by category
- Assembling a labeled image set for a classifier (food, interior, exterior) using the category as the label
- Spot-checking listing quality by sampling the first page of photos for a batch of businesses
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.