{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper with Emails", "description": "Scrapes Google Maps for any search query in any country. Extracts business name, phone, email, website, address, category, and rating. Visits each place's website to find email addresses. Built for mass scraping.", "version": "0.1", "x-build-id": "0sXlgtUa10QdJwnaV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pheidias0~google-maps-scraper-with-emails/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pheidias0-google-maps-scraper-with-emails", "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/pheidias0~google-maps-scraper-with-emails/runs": { "post": { "operationId": "runs-sync-pheidias0-google-maps-scraper-with-emails", "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/pheidias0~google-maps-scraper-with-emails/run-sync": { "post": { "operationId": "run-sync-pheidias0-google-maps-scraper-with-emails", "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 Keywords", "type": "array", "description": "What to search on Google Maps (e.g. 'plumber', 'dentist', 'restaurant'). Each keyword will be searched at every grid cell in the location area.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "City, region, or country to search in. The actor geocodes this into a bounding box and splits it into a geo-grid so it can find thousands of results instead of Google's 120 limit. Leave empty if your keywords already include locations." }, "startUrls": { "title": "Google Maps URLs", "type": "array", "description": "Optional. Paste Google Maps place or search URLs directly instead of using keywords.", "items": { "type": "object" } }, "maxCrawledPlacesPerSearch": { "title": "Max places per search", "minimum": 0, "type": "integer", "description": "Max places to extract per grid cell or search. Set to 0 for no limit. With geo-grid, each cell can return up to ~120 places — the grid gives you coverage across the whole area.", "default": 50 }, "placeMinimumStars": { "title": "Minimum star rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only include places with this rating or higher. Set to 0 to include all.", "default": 0 }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Skip places marked as permanently or temporarily closed.", "default": false }, "scrapeEmails": { "title": "Scrape emails & social media from websites", "type": "boolean", "description": "Visit each place's website via fast HTTP to extract email, Facebook, Instagram, Twitter, LinkedIn. Uses Crawlee social utilities + contact form extraction.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language for Google Maps ('en', 'fr', 'es', 'de', 'ar', 'ja', etc.).", "default": "en" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel browser pages. Higher = faster. With geo-grid you want 5-10 for speed. Safe range: 3-10.", "default": 5 }, "zoom": { "title": "Zoom level (0 = auto)", "minimum": 0, "maximum": 17, "type": "integer", "description": "Controls geo-grid density. 0 = auto-detect from location size. Lower zoom (11-12) = fewer larger cells, faster but may miss places. Higher zoom (14-15) = more smaller cells, slower but more thorough.", "default": 0 } } }, "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 } } } } } } } } } }