Google Maps Photos API - Bulk Place Photos
Pricing
from $0.01 / 1,000 results
Get every photo Google Maps holds for a place as structured JSON: full-size image URLs, thumbnails, gallery position, and a stable photo ID. Filter to menu, food and drink, vibe, by owner, videos, or street view. Chain it from a places search or paste a map URL. Pay per photo, MCP-ready.
Result Type
result_type
Optional
Which kind of row this is: 'photo' for a single photo, 'place_summary' for the per-place totals and gallery categories, or 'error' when a place could not be fetched.
Place ID
data_id
Optional
The Google Maps place identifier this row belongs to. Same value as the dataId field returned by the Google Maps Places API Actor.
Place Title
place_title
Optional
Name of the place, as matched by a search. Present on every row belonging to a place found via searchTerm. Absent when the place was supplied directly as a place ID or URL.
Position
position
Optional
1-indexed position of this photo within the place's gallery, in the order the source returns them.
Image URL
image
Optional
URL of the full-size photo.
Thumbnail URL
thumbnail
Optional
URL of a smaller preview version of the same photo.
Photo ID
photo_id
Optional
Stable identifier for this individual photo. Use it to de-duplicate across runs.
Category ID
category_id
Optional
The gallery category this photo was filtered to, when a category filter was applied. Absent on unfiltered runs.
Photos Returned
photos_returned
Optional
Number of photos returned for this place. Only present on place_summary rows.
Pages Fetched
pages_fetched
Optional
How many pages of 20 were fetched to satisfy this place. Only present on place_summary rows.
Place Categories
place_categories
Optional
Every gallery category this place offers, each with a title and an ID. Feed an ID back in as Custom Category ID to fetch just that section. Only present on place_summary rows.
[ { "title": "Menu", "id": "CgIYIQ" }]Fetched At
fetched_at
Optional
UTC timestamp for when this row was retrieved.
Error Message
error_message
Optional
Plain-language reason this place could not be fetched. Only present on error rows.
Error Type
error_type
Optional
Machine-readable error category: MissingRequiredParameter, MissingApiKey, InvalidDataId, InsufficientFunds, or MapsPhotosError. Only present on error rows.