| πΌοΈ Image URL at your size (`imageUrl`) |
π 200 px thumbnail (`thumbnailUrl`) |
π Original width and height |
| π¬ Video MP4, HLS, DASH + length |
π
Upload time (`uploadedAt`, hour) + day taken |
π’ Owner or visitor (`uploadedBy`) |
| π€ Uploader name (`contributorName`) |
π Uploader profile + id |
π¬ Caption + Google's translation |
| π± Source app (Android, iOS, web, business) |
β Posted with a review (`fromReview`) |
π Where it was taken (lat, lng) |
| π§ Heading of 360Β° / Street View |
π·οΈ Google's topic code |
π Photo ID |
| πΊοΈ Place name, address, category |
π’ Place ID, CID, feature id, KG id |
π Google's photo count, rating, reviews |
### How to scrape Google Maps photos with Google Maps Photos Scraper
1. [Create a free Apify account](https://console.apify.com/sign-up) (it comes with free monthly credit).
2. Open **Google Maps Photos Scraper** and paste Google Maps place links, or Place IDs, or a search term with a location.
3. Pick the photo categories and how many photos you want per place.
4. Click **Start**. Rows arrive place by place within seconds.
5. Download the dataset as JSON, CSV or Excel, or read it through the API.
### β¬οΈ Input
| Parameter | Type | Description |
|---|---|---|
| `startUrls` | array | Google Maps place links, `maps.app.goo.gl` share links, `?cid=` and `place_id:` links, or a CSV/TXT file of links. |
| `placeIds` | array | Place IDs (`ChIJβ¦`), CIDs (`3545819340560108778`) or feature ids (`0xβ¦:0xβ¦`), one per line. |
| `searchStringsArray` | array | Search terms as typed in Google Maps (`coffee shop`) or business names. |
| `locationQuery` | string | City, area or country for the search terms, e.g. `Seattle, WA`. |
| `maxCrawledPlacesPerSearch` | integer | Places per search term. Default 10; use 1 to look up a business by name. |
| `photoCategories` | array | `all` (default), `latest` (past 30 days, newest first), `videos`, `by_owner`, `street_and_360`. Several combine. |
| `mediaTypes` | array | `photo`, `video`, `photo360`, `streetView`. Empty = all. |
| `uploadedBy` | string | `any` (default), `owner` or `visitor`. |
| `language` | string | Language of names, categories and caption translations. Default `en`. |
| `photosNewerThan` / `photosOlderThan` | string | Upload date window: `2026-01-31`, `30 days`, `6 months`. |
| `withCaptionOnly` | boolean | Only photos with a caption. |
| `includeContributor` | boolean | Uploader name, profile, id and avatar. Default on, included in the price. |
| `monitorMode` / `monitorStoreName` | boolean / string | Deliver only photos no earlier run with the same store name has seen. |
| `maxPhotosPerPlace` | integer | Rows per place. Default 100; `0` = every photo Google lists. |
| `maxResults` | integer | Rows in total. `0` = no limit. |
| `imageSize` | string | `original` (default), `large` (1600 px), `medium` (800 px), `thumbnail` (200 px). |
| `compact` | boolean | Core fields only, for AI and MCP pipelines. |
| `maxConcurrency` | integer | Places read at once. Default 3. |
| `maxPhotosScannedPerPlace` | integer | With filters or Latest on: photos read per place to find matches. Default 5,000. |
| `proxyConfiguration` | object | Leave as is. |
#### Input JSON
```json
{
"startUrls": [{ "url": "https://www.google.com/maps/place/Katz%27s+Delicatessen/@40.722233,-73.987429,17z/data=!4m6!3m5!1s0x89c2598f7ff4aa09:0x313547e757cb8cea!8m2!3d40.722233!4d-73.987429" }],
"placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4"],
"searchStringsArray": ["dentist"],
"locationQuery": "Boise, ID",
"maxCrawledPlacesPerSearch": 5,
"photoCategories": ["all"],
"maxPhotosPerPlace": 100,
"imageSize": "large"
}
```
#### Paste the link of the place, not of the map
A place link carries the place's id (`!1s0xβ¦:0xβ¦`) or a `cid` / `place_id`. A link that only has coordinates (`/@40.72,-73.98,17z`) points at the map, not a place: click the place on Google Maps first, or use **Search terms** with its name and `maxCrawledPlacesPerSearch: 1`.
#### Use the categories to pay only for what you need
**Videos**, **By owner** and **Street View & 360Β°** keep only those photos, **Latest** keeps photos uploaded in the past 30 days and delivers them newest first. Photos the filters drop are read but never charged. With a filter on, the actor reads up to `maxPhotosScannedPerPlace` photos of each place to find `maxPhotosPerPlace` matches.
#### Get every photo of a place
Set `maxPhotosPerPlace` to `0`. The actor pages the place's public gallery to its end, 100 photos per request.
### β¬οΈ Output
One row per photo, video or 360Β° capture. A real row from a test run (long links shortened):
```json
{
"placeName": "Katz's Delicatessen",
"mediaType": "video",
"category": "all",
"photoId": "CIHM0ogKEICAgIDKz8nA1AE",
"imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Rmβ¦=s0",
"thumbnailUrl": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Rmβ¦=s200",
"videoUrl": "https://lh3.googleusercontent.com/gpms-cs-s/AM4Q-U8Wβ¦=m37",
"videoDurationSec": 60,
"width": 1920,
"height": 1080,
"uploadedAt": "2021-05-20T18:00:00.000Z",
"dateTaken": "2021-05-20",
"uploadedBy": "visitor",
"contributorName": "Steve Costello",
"contributorUrl": "https://maps.google.com/maps/contrib/105103597162936345941",
"source": "ios",
"sourceDetail": "photos:gmm_ios",
"latitude": 40.72223300082572,
"longitude": -73.98742897561966,
"placeId": "ChIJCar0f49ZwokR6ozLV-dHNTE",
"cid": "3545819340560108778",
"fid": "0x89c2598f7ff4aa09:0x313547e757cb8cea",
"address": "205 E Houston St, New York, NY 10002",
"placeCategory": "Deli",
"placeImagesCount": 95866
}
```
#### Fields and how often they are filled
Measured on Apify on the 2,873 rows of Katz's Delicatessen (every photo its gallery lists):
| Field | Filled | Meaning |
|---|---:|---|
| `photoId`, `imageUrl`, `thumbnailUrl`, `width`, `height` | 100% | Google's photo id, image links, original size |
| `uploadedAt`, `uploadDate`, `uploadTimestamp` | 100% | Upload time (Google gives the hour) |
| `dateTaken` | 99.4% (646-row run) | Day the photo was taken; 65% of those rows were uploaded on a later day |
| `uploadedBy`, `uploadedByOwner` | 100% | `owner`, `visitor` or `google` |
| `contributorName`, `contributorId`, `contributorUrl`, `contributorPhotoUrl` | 99.9% | The uploader |
| `source`, `sourceDetail`, `fromReview` | 100% | App the photo came from, posted with a review |
| `latitude`, `longitude` | 100% | Where it was taken |
| `caption` | 3% | What the uploader wrote (most write nothing) |
| `captionTranslated` | 1% | Google's translation, when the caption is in another language |
| `videoUrl`, `videoDurationSec`, `videoHlsUrl`, `videoDashUrl` | every video | 7 videos in this gallery |
| `heading` | every 360Β° / Street View capture | First view's compass heading |
| `internalCategoryCode` | 93% | Google's own topic code(s), raw |
| `placeName`, `placeId`, `cid`, `fid`, `placeKgmid`, `placeUrl`, `address`, `placeCategory`, `placeRating`, `placeReviewsCount`, `placeImagesCount` | 100% | The place |
| `searchString`, `placeRank` | rows found by a search | How the place was found |
The run's key-value store holds `RUN_SUMMARY` with one entry per place: Google's photo count, photos read, delivered, filtered, already delivered and whether the gallery was read to its end.
### Use cases
- π½οΈ **Menu and food catalogs**: every dish and menu photo of the restaurants in a city, with dates to keep the freshest.
- π **Local SEO and reputation**: how many photos a business posts versus its visitors, and how recent they are, across competitors.
- π¨ **Travel, hotel and real-estate listings**: interior, exterior and 360Β° imagery of venues to enrich pages.
- π§ **Image datasets**: labelled place photos with size, date, GPS and source app for vision models.
- π₯ **Video collection**: every visitor video of a place with a direct MP4 link.
- π **Brand monitoring**: a weekly monitor run delivers only the new photos customers post of your locations.
### How much does it cost to scrape Google Maps photos?
**$0.12 per 1,000 photos** (`photo` event), no start fee, no per-place or per-search fee. Uploader details, video links and the place summary are included. Filtered, duplicate and unreadable photos are free.
| Photos | Price |
|---:|---:|
| 100 | $0.012 |
| 1,000 | $0.12 |
| 10,000 | $1.20 |
| 100,000 | $12.00 |
Measured on Apify on 2026-10-28:
| Run | Places | Rows | Time | Price |
|---|---:|---:|---:|---:|
| Prefilled run (Katz's Delicatessen + Sydney Opera House, 25 each) | 2 | 50 | 6 s | $0.006 |
| Empty input (the same two places, 100 each) | 2 | 200 | 11 s | $0.024 |
| `pizza` in `Chicago, IL`, 3 places, 80 each | 3 | 240 | 6 s | $0.029 |
| Every photo of Katz's Delicatessen (`maxPhotosPerPlace: 0`) | 1 | 2,873 | 120 s | $0.34 |
| 5 places, 500 each, rebooted by Apify halfway | 5 | 2,297 | 72 s | $0.28 |
| Monitor run, nothing new since the last one | 3 | 0 | 2 s | $0 |
A run stops cleanly at the maximum charge you set: a $0.003 cap delivered and charged exactly 25 photos. A run Apify restarts on another server does not deliver or charge a photo twice.
### Integrations, API, scheduling & MCP
- β° **Schedules**: track your places weekly with `monitorMode` on; each run delivers only new photos.
- π **Webhooks**: get a call when a run finishes and fetch the dataset.
- π **Make, Zapier, n8n, Google Sheets, Slack**: through Apify's integrations.
- π§βπ» **API**: start runs and read rows with the [Python](https://docs.apify.com/api/client/python) or [JavaScript](https://docs.apify.com/api/client/js) client, or plain HTTP.
- π€ **MCP**: AI agents call it through the Apify MCP server.
Photos of one place from your own code:
```bash
curl -X POST "https://api.apify.com/v2/acts/TopApi~google-maps-photos-scraper/run-sync-get-dataset-items?token=