{ "openapi": "3.0.1", "info": { "title": "Google Maps & Google Business Profile Scraper", "description": "The most comprehensive Google Maps & Google Business Profile scraper. Extract business descriptions (\"From the business\"), reviews with full text, opening hours, photos, Q&A & all standard business data. Uses Camoufox stealth browser with fingerprinting & residential proxies for reliable extraction.", "version": "3.5", "x-build-id": "ft17Tbw7Pfe8PvLTL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-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/alizarin_refrigerator-owner~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-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/alizarin_refrigerator-owner~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-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", "properties": { "analysisMode": { "title": "Analysis Mode", "enum": [ "full", "list", "local-pack" ], "type": "string", "description": "'full' opens every business page for the complete profile (phone, website, hours, description, reviews). 'list' is fast: it reads the Google Maps results list only (name, category, rating, review count, map pin coordinates, place IDs, and the street address and phone when the list shows them) without opening each business page. 'local-pack' returns only the top 3 results per search.", "default": "full" }, "searchStringsArray": { "title": "Search Queries", "type": "array", "description": "List of search queries like 'Bar Fort Lauderdale FL' or 'Plumber Miami'. Used for search mode.", "items": { "type": "string" } }, "maxCrawledPlacesPerSearch": { "title": "Max Results Per Search", "minimum": 1, "maximum": 120, "type": "integer", "description": "Maximum number of places to return per search (per query and map position). Google Maps itself shows at most about 120 places per search.", "default": 20 }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Direct Google Place IDs (ChIJ...) or CIDs for detailed GBP scraping. Use this mode to get comprehensive data including description, reviews, hours, and photos for specific businesses.", "items": { "type": "string" } }, "maxReviews": { "title": "Max Reviews to Extract", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of reviews to extract per business (0 = no reviews). Reviews include author, rating, text, date, and response.", "default": 0 }, "reviewsSort": { "title": "Reviews Sort Order", "enum": [ "newest", "mostRelevant", "highestRating", "lowestRating" ], "type": "string", "description": "How to sort reviews before extraction", "default": "newest" }, "includeQA": { "title": "Include Q&A", "type": "boolean", "description": "Extract Questions & Answers section from the business profile", "default": false }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh" ], "type": "string", "description": "Language code for results", "default": "en" }, "lat": { "title": "Latitude", "type": "string", "description": "Center latitude for geo-biased search" }, "lng": { "title": "Longitude", "type": "string", "description": "Center longitude for geo-biased search" }, "zoom": { "title": "Zoom Level", "minimum": 1, "maximum": 20, "type": "integer", "description": "Map zoom level (10=city, 14=neighborhood, 17=street)", "default": 13 }, "searchLocations": { "title": "Map Positions (grid search)", "type": "array", "description": "Optional. Run every search query once at each of these map positions, written as \"lat,lng\" or \"lat,lng,zoom\" (for example \"32.7767,-96.7970,14\"). Use it to cover a larger area with several searches in one run. Places found by more than one search are returned and charged once. When set, Latitude and Longitude are ignored.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for best results. Apify Proxy exits in the United States unless you choose a country here (exits in Europe are sent to a Google consent page first).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Return one labeled sample record (free, nothing charged) instead of scraping. Off by default.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to POST results when scraping completes (Zapier, Make, n8n, custom endpoint)" }, "webhookPlatform": { "title": "Webhook Platform", "enum": [ "zapier", "make", "n8n", "custom" ], "type": "string", "description": "Platform type for webhook payload formatting", "default": "custom" }, "webhookHeaders": { "title": "Custom Webhook Headers", "type": "object", "description": "Additional HTTP headers to send with webhook (e.g., authorization tokens)" } } }, "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 } } } } } } } } } }