{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper | Emails & Social Media Enrichment", "description": "Extract business data from Google Maps at scale: names, addresses, phones, websites, emails, social media profiles (Facebook, Instagram, LinkedIn, Twitter/X, YouTube, Pinterest), ratings, reviews, GPS coordinates, and marketing tags (Google Analytics, GTM, Facebook Pixel).", "version": "1.0", "x-build-id": "hZfgScWSX94SlEplj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rp_openpro.ai~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rp_openpro.ai-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/rp_openpro.ai~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-rp_openpro.ai-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/rp_openpro.ai~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-rp_openpro.ai-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": [ "searchStringsArray" ], "properties": { "searchStringsArray": { "title": "Search term(s)", "type": "array", "description": "Enter one or more search terms exactly as you would type them in Google Maps (e.g., \"restaurant\", \"plumber\", \"dentist near me\"). Each term runs as a separate search. Use distinct terms for best results — overlapping terms like \"restaurant\" and \"restaurants\" waste time with duplicates.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "Free-text location to search in. Use simple formats like \"City, Country\" for best results (e.g., \"Paris, France\", \"Brooklyn, New York, USA\"). The scraper navigates Google Maps to this location before searching. Leave empty to search globally (not recommended — results will be scattered)." }, "maxCrawledPlacesPerSearch": { "title": "Max places per search term", "minimum": 0, "type": "integer", "description": "Maximum number of places to extract per search term. Lower values = faster runs and lower cost. Set to 0 or leave empty to extract all available places (may take longer). Google Maps typically surfaces 20-120+ results depending on the area density.", "default": 100 }, "language": { "title": "Language", "enum": [ "en", "fr", "de", "es", "it", "pt-BR", "pt-PT", "nl", "pl", "ru", "ja", "ko", "zh-CN", "zh-TW", "ar", "tr", "sv", "da", "no", "fi", "cs", "ro", "hu", "el", "bg", "hr", "sk", "sl", "uk", "he", "th", "vi", "id", "ms" ], "type": "string", "description": "Language for result details (business names, addresses, categories, opening hours). Passed as the \"hl\" parameter to Google Maps. Does not filter results by language — it only changes the display language.", "default": "en" }, "scrapeContacts": { "title": "Enrich with website contacts", "type": "boolean", "description": "When enabled, the scraper visits each business website to extract: emails (prioritizes contact@, hello@, info@), social media profiles (Facebook, Instagram, LinkedIn, Twitter/X, YouTube, Pinterest), and marketing/advertising tags (Google Analytics, Google Tag Manager, Facebook Pixel). Adds ~1-2 seconds per place but transforms basic listings into outreach-ready leads. Disable for maximum speed if you only need core Google Maps data.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy (default: datacenter) is recommended. For quick tests and lower cost, keep the default — do NOT add RESIDENTIAL to apifyProxyGroups unless Google blocks datacenter IPs (residential is slower and more expensive). Custom proxy URLs are supported." } } }, "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 } } } } } } } } } }