{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper",
"description": "Extract Google Maps place data from search terms or URLs, including name, category, ratings, address, contact details, coordinates, reviews, and images, with structured dataset output ready for analysis or export.",
"version": "0.0",
"x-build-id": "Bn1csF3AwVgqWqhX1"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lisbuenas~google-maps-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lisbuenas-google-maps-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/lisbuenas~google-maps-scraper/runs": {
"post": {
"operationId": "runs-sync-lisbuenas-google-maps-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/lisbuenas~google-maps-scraper/run-sync": {
"post": {
"operationId": "run-sync-lisbuenas-google-maps-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",
"required": [
"addresses"
],
"properties": {
"addresses": {
"title": "Search terms, addresses or place URLs",
"type": "array",
"description": "What to search on Google Maps. Accepts free-text searches (e.g. coffee shops in Manhattan), addresses, full google.com/maps place URLs or place IDs (ChI…).",
"items": {
"type": "string"
}
},
"location": {
"title": "Location appended to each search",
"type": "string",
"description": "Optional location added to every search term, e.g. Curitiba, PR."
},
"categories": {
"title": "Category filter",
"type": "array",
"description": "Only keep places whose Google category matches one of these values (case-insensitive, partial match).",
"items": {
"type": "string"
}
},
"maxCrawledPlacesPerSearch": {
"title": "Max places per search term",
"minimum": 1,
"type": "integer",
"description": "Stop collecting results for a single search term after this many places. Lower values finish faster.",
"default": 20
},
"maxCrawledPlaces": {
"title": "Max places total",
"minimum": 1,
"type": "integer",
"description": "Hard cap on the number of places scraped across all search terms.",
"default": 200
},
"includeReviews": {
"title": "Scrape reviews",
"type": "boolean",
"description": "Open the reviews tab of each place and extract individual reviews (slower).",
"default": false
},
"maxReviews": {
"title": "Max reviews per place",
"minimum": 0,
"type": "integer",
"description": "Maximum number of reviews extracted per place when review scraping is enabled.",
"default": 5
},
"includeImages": {
"title": "Scrape images",
"type": "boolean",
"description": "Extract image URLs for each place. When disabled, image downloads are blocked to speed up crawling.",
"default": false
},
"maxImages": {
"title": "Max images per place",
"minimum": 0,
"type": "integer",
"description": "Maximum number of image URLs extracted per place when image scraping is enabled.",
"default": 10
},
"language": {
"title": "Results language",
"type": "string",
"description": "Two-letter language code used for Google Maps (hl parameter).",
"default": "en"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many pages are scraped in parallel. Higher is faster but increases the chance of Google rate-limiting.",
"default": 2
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies used by the scraper. Google Maps aggressively blocks repeated datacenter traffic, so keeping Apify Proxy enabled is strongly recommended.",
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}