{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Photos Scraper: Images & Videos",
"description": "Google Maps photos scraper: a place's photos and videos, one row each, with image and MP4 links, size, upload date, owner or visitor, source and location. Categories: menu, food & drink, vibe, latest, by owner, Street View & 360°, videos, hotel rooms. By link, ID or search. No login.",
"version": "0.1",
"x-build-id": "ylMXqrOALnvfiGEH6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/deepmine~google-maps-photos-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-deepmine-google-maps-photos-scraper",
"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/deepmine~google-maps-photos-scraper/runs": {
"post": {
"operationId": "runs-sync-deepmine-google-maps-photos-scraper",
"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/deepmine~google-maps-photos-scraper/run-sync": {
"post": {
"operationId": "run-sync-deepmine-google-maps-photos-scraper",
"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",
"properties": {
"startUrls": {
"title": "📍 Google Maps places",
"type": "array",
"description": "Place links (https://www.google.com/maps/place/..., share links maps.app.goo.gl/..., ?cid= links). A search link (https://www.google.com/maps/search/cafe/@48.86,2.35,14z) runs as a search.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "🗃️ Place IDs",
"type": "array",
"description": "Google place IDs (ChIJdzf8kEZZwokRXtSOY0-Kwaw), CIDs (12448382918606115934) or FIDs (0x89c2598f7ff4aa09:0x313547e757cb8cea).",
"items": {
"type": "string"
}
},
"photoCategories": {
"title": "🗂️ Photo categories",
"type": "array",
"description": "Which of the place's photo tabs to collect. All = every tab, each photo once (Google's All tab, every visitor photo, Menu, Food & drink, Vibe, videos, Street View & 360°, the owner's photos and a hotel's Rooms, Amenities, Inside and Exterior). A tab the place doesn't have costs nothing. Each row says which category returned it.",
"items": {
"type": "string",
"enum": [
"all",
"latest",
"menu",
"food_and_drink",
"vibe",
"by_owner",
"street_and_360",
"videos",
"rooms",
"amenities",
"inside",
"exterior"
],
"enumTitles": [
"All photos and videos",
"Latest (past month, newest first)",
"Menu",
"Food & drink",
"Vibe",
"By owner",
"Street View & 360°",
"Videos",
"Rooms",
"Amenities",
"Inside",
"Exterior"
]
},
"default": [
"all"
]
},
"maxPhotosPerPlace": {
"title": "💯 Photos per place",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Rows each place returns at most (photos, videos and Street View captures together), e.g. 500. 0 = every one Google Maps serves.",
"default": 100
},
"imageSize": {
"title": "🖼️ Image size",
"enum": [
"original",
"large",
"medium",
"thumbnail"
],
"type": "string",
"description": "Size of every image link: Original (as uploaded), Large (1600 px longest side), Medium (800 px) or Thumbnail (200 px). Every row also has a 200 px thumbnailUrl. Street View captures are at most 1024 x 512.",
"default": "original"
},
"searchStringsArray": {
"title": "🔍 Search terms",
"type": "array",
"description": "Find places by what you would type in Google Maps, e.g. coffee shop; each place found returns its photos.",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "📍 Location",
"type": "string",
"description": "City, neighborhood, ZIP code, state or country, e.g. Boise, ID or Berlin, Germany. Results stay inside the location's own boundary (a city search doesn't spill into its suburbs). Large areas are searched ZIP code by ZIP code and tile by tile automatically. Empty = Google picks the area your term names."
},
"maxCrawledPlacesPerSearch": {
"title": "🏘️ Places per search term",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Places each search term returns at most. Empty = every place Google Maps has for it in the location.",
"default": 20
},
"customGeolocation": {
"title": "🛰️ Custom search area (GeoJSON)",
"type": "object",
"description": "A GeoJSON Polygon or MultiPolygon ([longitude, latitude] order), or a Point with radiusKm. Overrides the location. Only places inside are kept."
},
"language": {
"title": "🌍 Language",
"enum": [
"en",
"es",
"fr",
"de",
"it",
"pt-BR",
"pt-PT",
"nl",
"pl",
"cs",
"sk",
"hu",
"ro",
"bg",
"el",
"tr",
"ru",
"uk",
"sv",
"da",
"no",
"fi",
"et",
"lv",
"lt",
"hr",
"sl",
"sr",
"ja",
"ko",
"zh-CN",
"zh-TW",
"th",
"vi",
"id",
"ms",
"fil",
"hi",
"ar",
"he",
"fa"
],
"type": "string",
"description": "Language of names, categories, hours and reviews, as Google Maps shows them.",
"default": "en"
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Leave as is: Apify datacenter proxy works for Google Maps. A call every datacenter IP refused is retried once on a residential IP.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}