# Google Maps Photos Scraper (`coregent/google-maps-photos-scraper`) Actor Scrape public photos from Google Maps places. Extract full-resolution image URLs, thumbnails, photo IDs, dimensions, contributor details, dates, captions, photo coordinates and place metadata from Maps URLs, Place IDs, CIDs, data IDs, business names or coordinates. No Google login or API key. - **URL**: https://apify.com/coregent/google-maps-photos-scraper.md - **Developed by:** [Delowar Munna](https://apify.com/coregent) (community) - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.30 / 1,000 photo results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Google Maps Photos Scraper ![Google Maps Photos Scraper](https://raw.githubusercontent.com/coregentdevspace/google-maps-photos-scraper-assets/main/thumbnail-google-maps-photos-scraper.png "Google Maps Photos Scraper") **Full-Resolution Photos, Contributors & Metadata** Scrape public photos from Google Maps places. Extract full-resolution image URLs, thumbnails, photo IDs, dimensions, contributor details, dates, captions, photo coordinates and place metadata. Process many places in one run and export clean JSON, CSV or Excel. No Google API key, no Google login and no cookies needed. ### โœจ What you get One row per photo: - ๐Ÿ–ผ๏ธ **Full-resolution image URL** at the original pixel size Google stores, plus a **thumbnail URL** - ๐Ÿ†” **Photo ID** (stable, used for deduplication) - ๐Ÿ“ **Width and height** in pixels (from Google โ€” images are never downloaded to measure them) - ๐Ÿ‘ค **Contributor**: name, profile URL and contributor ID - ๐Ÿ“… **Date taken** and **date uploaded**, kept separate - ๐Ÿ“ **Caption**, where the contributor wrote one - ๐Ÿ“ **Photo coordinates**, kept separate from the place location - ๐Ÿท๏ธ **Photo type** (`USER`, `OWNER`, `STREET_VIEW`, `UNKNOWN`) and **format** (`PHOTO`, `PANORAMA_360`) - ๐Ÿข **Place context**: Place ID, CID, data ID, name, address, Google Maps URL, latitude / longitude - ๐Ÿงพ Free **place summary rows** with a status and coverage label for every place you asked for ### ๐Ÿ“ฅ Supported inputs | Input | Example | | --------------------- | --------------------------------------------------------------------------------- | | Google Maps place URL | `https://www.google.com/maps/place/Sydney+Opera+House/@-33.85,151.21,17z/data=!โ€ฆ` | | Short share link | `https://maps.app.goo.gl/โ€ฆ` | | Place ID | `ChIJN1t_tDeuEmsRUsoyG83frY4` | | CID | `3545450935484072529` | | Data ID | `0x6b12ae665e892fdd:0x3133f8d75a1ac251` | | Business name | `Sydney Opera House` (+ optional Location) | | Coordinates + radius | `{ "lat": 38.8960382, "lng": -77.0365611, "radiusMeters": 25, "maxResults": 20 }` | Mix as many as you like. Equivalent places (the same place given as a URL and a Place ID) are scraped once. If a business name matches several places (e.g. a chain), that input returns **`AMBIGUOUS_PLACE`** with the candidates listed instead of a guess. Use a Maps URL or Place ID for those. ### โš™๏ธ Input examples #### Place ID ```json { "placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4"], "maxPhotosPerPlace": 100 } ``` #### Several places, full metadata ```json { "placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4", "ChIJ3S-JXmauEmsRUcIaWtf4MzE"], "cids": ["3545450935484072529"], "maxPhotosPerPlace": 500, "includeContributor": true, "includeDate": true, "includeGeo": true } ``` #### Maps URL, recent photos only ```json { "startUrls": [{ "url": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE" }], "maxPhotosPerPlace": 1000, "photosNewerThan": "6 months" } ``` #### Coordinates + radius ```json { "points": [{ "lat": 38.8960382, "lng": -77.0365611, "radiusMeters": 25, "maxResults": 20 }] } ``` #### Main options | Field | Default | What it does | | -------------------- | ------- | ----------------------------------------------------------------------------- | | `maxPhotosPerPlace` | `100` | Maximum photos returned per place (up to 5,000). | | `photosNewerThan` | โ€” | Keep only photos uploaded on or after a date (`"30 days"`, `"2026-01-01"`). | | `includeContributor` | `true` | Contributor name, profile URL and ID (also enables USER / OWNER photo types). | | `includeDimensions` | `true` | Width and height. | | `includeDate` | `true` | Date taken and date uploaded. | | `includeCaption` | `true` | Caption, where one exists. | | `includeGeo` | `true` | Photo-specific coordinates. | | `emitPlaceSummaries` | `true` | One free summary row per place / point. | Turning off contributor, dates and caption makes runs several times faster, because those fields need one extra lookup per photo. ### ๐Ÿ“ค Output The dataset has two views: **Photos** (one row per photo, with a thumbnail preview) and **Places** (one free status row per place). Export either view as JSON, CSV, Excel or HTML, or read it through the API. ![Google Maps Photos Scraper โ€” Photos table view](https://raw.githubusercontent.com/coregentdevspace/google-maps-photos-scraper-assets/main/google-maps-photos-scraper-output-photos-table-views.png "Google Maps Photos Scraper โ€” Photos table view") The samples below come from the default run (Sydney Opera House, 100 photos). The contributor's name is replaced with a placeholder. #### Photo row (Photos tab) ```json { "rowType": "photo", "photoId": "CIHM0ogKEICAgIDxhJ_24QE", "fullResolutionUrl": "https://lh3.googleusercontent.com/gpms-cs-s/AM4Q-U_3F1fWHZCgd-MTFmLXZ64LvhD9n2i8QDhi4kSn8N8y6MRN4-JFVOt6Km07QkAOjNXcLCNYPb5Puj2NDU8WXeE9y9-uSkmuErDGbxZTJAVt334_CjZ9UDyXU6EHiivJEOXKrE_l=w16320-h12240-k-no", "thumbnailUrl": "https://lh3.googleusercontent.com/gpms-cs-s/AM4Q-U_3F1fWHZCgd-MTFmLXZ64LvhD9n2i8QDhi4kSn8N8y6MRN4-JFVOt6Km07QkAOjNXcLCNYPb5Puj2NDU8WXeE9y9-uSkmuErDGbxZTJAVt334_CjZ9UDyXU6EHiivJEOXKrE_l=s400-k-no", "width": 16320, "height": 12240, "caption": null, "dateTaken": "2023-05-27", "uploadedAt": "2023-06-01", "photoType": "USER", "mediaFormat": "PHOTO", "contributorName": "Example Contributor", "contributor": { "name": "Example Contributor", "profileUrl": "https://www.google.com/maps/contrib/104046596102022730445", "contributorId": "104046596102022730445" }, "geo": { "latitude": -33.85678437208739, "longitude": 151.2152966806911 }, "placeName": "Sydney Opera House", "placeId": "ChIJ3S-JXmauEmsRUcIaWtf4MzE", "place": { "placeId": "ChIJ3S-JXmauEmsRUcIaWtf4MzE", "cid": "3545450935484072529", "dataId": "0x6b12ae665e892fdd:0x3133f8d75a1ac251", "name": "Sydney Opera House", "address": "Bennelong Point, Sydney NSW 2000, Australia", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE&hl=en", "latitude": -33.8567844, "longitude": 151.2152967 }, "input": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE", "scrapedAt": "2026-10-13T15:56:42.731Z" } ``` Unavailable fields are `null`. Dates are calendar dates: Google doesn't publish a time zone, so no time of day is invented. #### Place summary row (Places tab, free) ```json { "rowType": "place_summary", "input": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE", "placeId": "ChIJ3S-JXmauEmsRUcIaWtf4MzE", "cid": "3545450935484072529", "dataId": "0x6b12ae665e892fdd:0x3133f8d75a1ac251", "placeName": "Sydney Opera House", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE&hl=en", "status": "SUCCESS", "coverageStatus": "LIMIT_REACHED", "photosReturned": 100, "photosScanned": 105, "photosFilteredOut": 0, "placePhotosCount": 540630, "error": null, "scrapedAt": "2026-10-13T15:56:49.559Z" } ``` `LIMIT_REACHED` means the run stopped at your `maxPhotosPerPlace`. `photosScanned` also counts videos (skipped and free) and items read past the limit on the last page, so it can be a little higher than `photosReturned`. #### Partial coverage example When Google shows a signed-out visitor fewer photos than the place's photo count, the place says so instead of looking complete: ```json { "rowType": "place_summary", "input": "ChIJN1t_tDeuEmsRUsoyG83frY4", "placeName": "Google Sydney - Pirrama Road", "status": "PARTIAL_RESULT", "coverageStatus": "PARTIAL_PUBLIC", "photosReturned": 1019, "photosScanned": 1027, "photosFilteredOut": 0, "placePhotosCount": 1940, "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4", "cid": "10281119596374313554", "dataId": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en", "error": "Google listed 1027 of 1940 photos to a signed-out visitor." } ``` #### Error / no-photo example ```json { "rowType": "place_summary", "input": "Starbucks", "status": "AMBIGUOUS_PLACE", "coverageStatus": "PLACE_NOT_FOUND", "photosReturned": 0, "error": "\"Starbucks\" matched 10 places (e.g. Starbucks George Street; Starbucks York Street; โ€ฆ). Use a Maps URL or Place ID instead." } ``` A place with no public photos returns `status: "NO_PHOTOS"` / `coverageStatus: "NO_PHOTOS"`. **Statuses:** `SUCCESS`, `NO_PHOTOS`, `INVALID_PLACE`, `PLACE_NOT_FOUND`, `AMBIGUOUS_PLACE`, `RATE_LIMITED`, `BLOCKED`, `PARTIAL_RESULT`, `TEMPORARY_GOOGLE_ERROR`, `PROVIDER_ERROR`. **Coverage:** `FULL_AVAILABLE_SET`, `LIMIT_REACHED`, `PARTIAL_PUBLIC`, `NO_PHOTOS`, `PLACE_NOT_FOUND`, `PROVIDER_LIMITED`, `BLOCKED`. One failed place never fails the whole run. Retryable failures are saved to the `RETRY_INPUT` record in the key-value store, so you can paste them straight into a new run. Run totals (places, photos, duplicates, videos skipped, field availability, photo types, runtime, requests per 1,000 photos) are in `RUN_SUMMARY`. ### โ“ FAQ **Which inputs are supported?** Maps place URLs, short share links, Place IDs, CIDs, data IDs, business names (optionally with a location) and coordinates + radius. **Do I need a Google API key?** No. No API key and no Maps Platform billing. **Do I need a Google login?** No. No login, no cookies, no browser extension. **Can I process multiple places?** Yes โ€” as many as you like in one run, in parallel. **Are images full resolution?** Yes. `fullResolutionUrl` requests the exact original dimensions Google reports for the photo (e.g. 4032 ร— 3024), not a carousel thumbnail. **Are thumbnails included?** Yes โ€” `thumbnailUrl`, a 400-pixel version of the same image. **Are contributor details included?** Yes, the public ones: name, profile URL and contributor ID. Contributors are not enriched from outside Google. **Are dates included?** Yes โ€” `dateTaken` and `uploadedAt`, kept separate, as calendar dates. **Are photo coordinates included?** Yes โ€” `geo` holds the photo's own coordinates; the place's location is in `place.latitude` / `place.longitude`. **How many photos can I get per place?** Up to 5,000 per run via `maxPhotosPerPlace`. In practice Google lists roughly 1,000โ€“1,400 photos of a place to signed-out visitors, even when its gallery header advertises far more. **Why might I get fewer photos than Google displays?** Google's headline photo count includes photos it doesn't list publicly, and it stops paging a gallery for signed-out visitors after roughly 1,000โ€“1,400 photos. When that happens the place summary says `PARTIAL_PUBLIC` / `PARTIAL_RESULT`, with both numbers, instead of pretending the set was complete. Videos in the gallery are skipped and not charged. **Are images downloaded, or only URLs returned?** Only URLs and metadata. No image file is downloaded or stored. **How does pricing work?** You pay per unique photo delivered โ€” see Pricing below. **Can I use it via API / MCP?** Yes. Call it from the Apify API, the JavaScript / Python clients, or any MCP-capable AI agent through the Apify MCP server. **Can I schedule recurring runs?** Yes โ€” create an Apify Schedule (for example with `photosNewerThan: "7 days"`) and connect a webhook, Make, Zapier, n8n or Google Sheets integration. ### ๐Ÿ’ฐ Pricing Pay per result: you are charged **once per unique photo delivered** to the dataset. You are **not** charged for: - place resolution, pagination or retries, - duplicates, - photos removed by `photosNewerThan`, - videos, - failed or ambiguous places, - `place_summary` rows. There is no start fee, so a run that returns no photos costs nothing. See the **Pricing** tab on this Actor's page for current rates. This README deliberately doesn't quote figures, because live prices are set in the Apify Console. Per-run spending limits you set on Apify are respected: the run stops cleanly when the limit is reached. #### ๐Ÿšฆ Proxy policy Use **Apify Datacenter** proxy (the default) or **no proxy** โ€” both work for Google Maps photo galleries at this Actor's conservative concurrency. **Apify Residential proxy is not supported.** The Actor fails at startup if `apifyProxyGroups` includes `RESIDENTIAL`. Reason: in pay-per-event Actors, residential bandwidth is billed to the developer, not the run user, so a single bandwidth-heavy run could exceed the per-photo revenue. If you genuinely need residential routing, supply your own residential provider via the proxy editor's **Custom proxy URLs** field. That traffic goes through your provider, not Apify, so this block doesn't apply to it: ``` http://user:pass@proxy.iproyal.com:12321 http://user:pass@proxy.brightdata.com:22225 http://user:pass@proxy.oxylabs.io:7777 ``` ### ๐Ÿ”— Works well with - **Google Maps Reviews Scraper** โ€” the same place identity (`placeId`, `cid`, `dataId`, `googleMapsUrl`), so photos and reviews join cleanly. - **Coregent Google Maps business / lead Actors** โ€” discover places, then pass their Place IDs here. Typical chain: business / lead scraper โ†’ `placeId` โ†’ this Actor โ†’ visual research, listing audits or computer-vision pipelines. ### โš–๏ธ Compliance and privacy - This is an unofficial tool and is not affiliated with, endorsed by or sponsored by Google. - It returns **public** Google Maps photo URLs and metadata only. - Contributor profiles can contain personal information. You are responsible for lawful processing of what you collect (e.g. GDPR / CCPA) and for respecting Google's terms. - Image copyright stays with the owners and uploaders. You are responsible for lawful downstream use. - Photos can be removed or changed by Google or their contributors at any time, so URLs may stop working. - The Actor does not upload photos, access private media, collect credentials, de-anonymize contributors or infer sensitive attributes. ### ๐Ÿ› ๏ธ Limitations - Google lists roughly 1,000โ€“1,400 photos per place to signed-out visitors; deeper gallery history isn't reachable. Places affected are labelled `PARTIAL_PUBLIC`. - Captions are rare on Google Maps, so `caption` is usually `null`. - `photoType` comes from metadata only, never from image content: `OWNER` when the contributor is the business profile, `STREET_VIEW` for Google's own Street View imagery, `USER` otherwise, `UNKNOWN` when contributor details are turned off. - Gallery order is Google's own (not chronological), so `photosNewerThan` scans the listed gallery rather than stopping early. - Coordinates mode samples points around the centre and returns the nearest public user photos Google finds within the radius; Google's own Street View panoramas are not included. It's a nearby-photo finder, not an exhaustive area crawl. - Videos are skipped. # Actor input Schema ## `startUrls` (type: `array`): Google Maps place URLs or short share links (maps.app.goo.gl/โ€ฆ). One place per URL. The sample place is ignored automatically when you fill any other place input. ## `placeIds` (type: `array`): Google Place IDs, e.g. ChIJN1t_tDeuEmsRUsoyG83frY4. ## `cids` (type: `array`): Google Maps CIDs (customer IDs) โ€” digits only, e.g. 3545450935484072529. ## `dataIds` (type: `array`): Google Maps data / feature IDs in 0xโ€ฆ:0xโ€ฆ form, e.g. 0x6b12ae665e892fdd:0x3133f8d75a1ac251. ## `businessNames` (type: `array`): Business names to look up on Google Maps (combined with Location when set). If a name matches several places, that input returns an AMBIGUOUS_PLACE status instead of guessing. ## `location` (type: `string`): Narrows Business names, e.g. Canberra, ACT, Australia. ## `points` (type: `array`): Find public photos near coordinates instead of a place. Each item: {"lat": 38.8960382, "lng": -77.0365611, "radiusMeters": 25, "maxResults": 20}. radiusMeters up to 1,000, maxResults up to 100. Google's own Street View panoramas are not included. ## `maxPhotosPerPlace` (type: `integer`): Maximum photos returned per place. Common values: 20, 50, 100, 500, 1000. Google may list fewer photos to signed-out visitors than its gallery total โ€” the place summary row reports this. ## `photosNewerThan` (type: `string`): Keep only photos uploaded on or after this date. Relative ("30 days", "6 months", "1 year") or absolute ("2026-01-01"). Empty = no limit. Filtered-out photos are never charged. ## `includeContributor` (type: `boolean`): Contributor name, profile URL and ID. Also enables the USER / OWNER photo type. ## `includeDimensions` (type: `boolean`): Original width and height in pixels, as reported by Google (images are never downloaded). ## `includeDate` (type: `boolean`): Date taken and date uploaded, kept separate. Google gives calendar dates only, so no time of day is invented. ## `includeCaption` (type: `boolean`): The photo caption, where the contributor wrote one. ## `includeGeo` (type: `boolean`): Photo-specific latitude / longitude, kept separate from the place location. ## `language` (type: `string`): Google Maps interface language code, e.g. en, de, fr. Affects place names and categories. ## `emitPlaceSummaries` (type: `boolean`): Add one free place_summary row per place or point with its status, coverage and counts (also used to report failed places). Never charged. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Defaults to Apify Datacenter (useApifyProxy: true). Apify Residential is NOT supported and fails the run at startup; for residential routing supply your own provider via Custom proxy URLs (proxyConfiguration.proxyUrls). ## Actor input object example ```json { "startUrls": [ { "url": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE" } ], "placeIds": [], "cids": [], "dataIds": [], "businessNames": [], "location": "", "points": [], "maxPhotosPerPlace": 100, "photosNewerThan": "", "includeContributor": true, "includeDimensions": true, "includeDate": true, "includeCaption": true, "includeGeo": true, "language": "en", "emitPlaceSummaries": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): One row per unique photo with full-resolution URL, thumbnail, dimensions, contributor, dates, caption, photo coordinates and place context. ## `places` (type: `string`): Free per-place summary rows: status, coverage and photo counts. # 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 = { "startUrls": [ { "url": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE" } ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("coregent/google-maps-photos-scraper").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 = { "startUrls": [{ "url": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE" }], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("coregent/google-maps-photos-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.google.com/maps/place/?q=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE" } ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call coregent/google-maps-photos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,coregent/google-maps-photos-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/9J1BhuJgisnr4j9f5/builds/e1gVtPdIZWpqEIHTb/openapi.json