# Google Maps Photos Scraper (`crawlerbros/google-maps-photos`) Actor Extract photos from any Google Maps place - carousel scraping with max-resolution URLs, contributor info, and category metadata. - **URL**: https://apify.com/crawlerbros/google-maps-photos.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Integrations - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Maps Photos Scraper Extract every photo from any Google Maps place — including max-resolution image URLs, contributor names, upload dates, captions, and category tabs (Food & Drink, Indoor, Outdoor, Menu, Videos, etc.). ### What It Does Give this actor a Google Maps place URL and it returns up to 5,000 photos for that place. For each photo you get: - **Max-resolution photo URL** (full-size, not thumbnail) - **Photo category** — All Photos, By Owner, By Visitors, Food & Drink, Outdoor, Indoor, Menu, Videos - **Contributor name** and profile URL (when available) - **Upload date** as a relative string (e.g. "2 months ago") - **Original dimensions** + aspect ratio + orientation - **Caption** and tags (when published by the contributor) - **Video flag** — distinguishes photos from short clips - **Business context** — `businessName`, `placeId`, `placeUrl` echoed on every record so the dataset stays joinable ### Use Cases - Build a visual asset library for restaurants, hotels, and venues - Track menu / interior photo updates over time - Source UGC photography for travel and food blogs - Power "what does this place look like" previews in custom apps - Enrich lead-generation pipelines with visual context ### Input | Field | Type | Required | Default | Description | |---|---|---|---|---| | `placeUrl` | String | Yes | — | Google Maps place URL | | `maxPhotos` | Integer | No | `100` | Maximum number of photos to extract (1–5000) | | `photoCategory` | Enum | No | `all` | Filter by tab: `all`, `by_owner`, `by_visitors`, `food_and_drink`, `outdoor`, `indoor`, `menu`, `videos` | | `enrichDetails` | Boolean | No | `true` | Visit each photo individually to capture contributor, date, dimensions, tags. Disable for ~3–5x faster runs that only return thumbnail-level data. | | `proxyConfiguration` | Object | No | Apify Proxy | Optional proxy settings | #### Example input ```json { "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9878584,17z/", "maxPhotos": 50, "photoCategory": "all", "enrichDetails": true } ```` ### Output One record per photo: ```json { "photoId": "AF1QipP...XYZ", "photoUrl": "https://lh3.googleusercontent.com/p/AF1QipP...XYZ=s0", "category": "by_visitors", "contributorName": "Jane Smith", "contributorUrl": "https://maps.google.com/maps/contrib/123...", "uploadDate": "2 months ago", "caption": "Sunset view from the observation deck", "width": 4032, "height": 3024, "aspectRatio": 1.33, "orientation": "landscape", "isVideo": false, "tags": ["sunset", "view", "observation deck"], "businessName": "Empire State Building", "placeId": "0x89c259a9b3117469:0xd134e199a405a163", "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/...", "rank": 1, "scrapedAt": "2026-06-16T12:00:00+00:00" } ``` Empty fields are omitted automatically — no `null` values in the dataset. ### FAQ **Does it need a proxy or cookies?** No login or cookies. A proxy is recommended for large runs to avoid rate limiting, and Apify Proxy is enabled by default. **Which categories does Google show?** Every place is different. Restaurants typically have Food & Drink + Menu, hotels have Indoor + Outdoor, and landmarks usually have a single "All Photos" tab. Selecting a category that doesn't exist for a place yields the All tab automatically. **What does `enrichDetails` actually do?** With enrichment on, the actor walks through every photo (one network request per photo) to capture contributor and upload metadata. With it off, only thumbnail-level fields (photoUrl, category, businessName) are returned — much faster but less detail. **Are video clips supported?** Yes — short video clips on Google Maps are included when `photoCategory` is `all` or `videos`, with `isVideo: true` on the record. **How many photos can I get per place?** Google Maps caps each photo tab at ~5,000 — the same limit this actor exposes. ### Data Source Public Google Maps web UI. No Google API key required. ### 🗺️ Complete Google Maps Scraper Suite This actor is part of a comprehensive Google Maps data extraction toolkit by **crawlerbros**. All actors run on the free Apify plan, use no proxy by default, and return clean, structured data. | Actor | What it does | |---|---| | 🏢 [Google Maps Business Scraper](https://apify.com/crawlerbros/google-maps-scraper) | Extract business data — name, address, phone, website, rating, reviews, hours, amenities | | ⭐ [Google Maps Reviews Scraper](https://apify.com/crawlerbros/google-maps-reviews-scraper) | Scrape reviews with reviewer Local Guide level, photos, mentioned items, owner replies | | 🕐 [Google Maps Business Hours Scraper](https://apify.com/crawlerbros/google-maps-business-hours) | Full 7-day hours, timezone, current local time, next open/close, holiday hours | | 📊 [Google Maps Popular Times Scraper](https://apify.com/crawlerbros/google-maps-popular-times) | Busy hours histogram for all 7 days + current busyness + typical visit time | | 📧 [Google Maps Email Extractor](https://apify.com/crawlerbros/google-maps-email-extractor) | Find business emails + social media links by crawling websites | | 🗺️ [Google Maps Area Scanner](https://apify.com/crawlerbros/google-maps-area-scanner) | Geographic grid scanning — bypass the 120-place limit with bounding box / circle / polygon | | 💼 [Google Maps Leads Scraper](https://apify.com/crawlerbros/google-maps-leads) | B2B lead generation with email + phone enrichment, US states + global countries | | 🤖 [Google Maps MCP Server](https://apify.com/crawlerbros/google-maps-mcp) | Unified MCP server combining search + reviews for AI assistants | | 🧭 [Google Maps Directions Scraper](https://apify.com/crawlerbros/google-maps-directions) | A→B routing — distance, duration, traffic, route alternatives for driving/walking/transit | | 📍 [Google Maps Geocoding Scraper](https://apify.com/crawlerbros/google-maps-geocoding) | Bidirectional geocoding — address ↔ coordinates, with address components | | 🔗 [Google Maps Similar Places Scraper](https://apify.com/crawlerbros/google-maps-similar-places) | "People also search for" / related place discovery — competitor & alternative finder | | 🍽️ [Google Maps Menu Scraper](https://apify.com/crawlerbros/google-maps-menu) | Restaurant menu items, prices, descriptions, photos | | 📌 [Google Maps Nearby Scraper](https://apify.com/crawlerbros/google-maps-nearby) | Find places near a coordinate point — lightweight POI search by category | | 📋 [Google Maps Place List Scraper](https://apify.com/crawlerbros/google-maps-place-list) | Extract Google's curated "Top X in Y" lists — best hotels/restaurants/things to do | | 🌍 [Google Maps Timezone Scraper](https://apify.com/crawlerbros/google-maps-timezone) | IANA timezone + current local time from coordinates | # Actor input Schema ## `placeUrl` (type: `string`): Google Maps URL of the place to scrape photos from. ## `maxPhotos` (type: `integer`): Maximum number of photos to extract (1-5000). ## `photoCategory` (type: `string`): Filter photos by category tab. ## `enrichDetails` (type: `boolean`): When enabled, walks through each photo to capture contributor name/URL, upload date, original dimensions, aspect ratio, orientation, video flag, and tags. Disable for ~3-5x faster runs that only return thumbnail-level data. ## `proxyConfiguration` (type: `object`): Proxy settings. ## Actor input object example ```json { "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9878584,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9878584!16zL20vMDJfMjg2", "maxPhotos": 20, "photoCategory": "all", "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9878584,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9878584!16zL20vMDJfMjg2", "maxPhotos": 20, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/google-maps-photos").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9878584,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9878584!16zL20vMDJfMjg2", "maxPhotos": 20, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/google-maps-photos").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "placeUrl": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9878584,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9878584!16zL20vMDJfMjg2", "maxPhotos": 20, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/google-maps-photos --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/google-maps-photos", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Photos Scraper", "description": "Extract photos from any Google Maps place - carousel scraping with max-resolution URLs, contributor info, and category metadata.", "version": "1.3", "x-build-id": "hlrIlFWY1Qok59FLF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~google-maps-photos/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-google-maps-photos", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~google-maps-photos/runs": { "post": { "operationId": "runs-sync-crawlerbros-google-maps-photos", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~google-maps-photos/run-sync": { "post": { "operationId": "run-sync-crawlerbros-google-maps-photos", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "placeUrl" ], "properties": { "placeUrl": { "title": "Place URL", "type": "string", "description": "Google Maps URL of the place to scrape photos from." }, "maxPhotos": { "title": "Max Photos", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of photos to extract (1-5000).", "default": 100 }, "photoCategory": { "title": "Photo Category", "enum": [ "all", "by_owner", "by_visitors", "food_and_drink", "outdoor", "indoor", "menu", "videos" ], "type": "string", "description": "Filter photos by category tab.", "default": "all" }, "enrichDetails": { "title": "Enrich Photo Details", "type": "boolean", "description": "When enabled, walks through each photo to capture contributor name/URL, upload date, original dimensions, aspect ratio, orientation, video flag, and tags. Disable for ~3-5x faster runs that only return thumbnail-level data.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```