{ "openapi": "3.0.1", "info": { "title": "Google Maps Local Business Lead Finder, Places and Contacts", "description": "Pull Google Maps by query or URL. Returns name, address, phone, website, rating, reviews, reviewer names, images, opening hours, and price range. Optional website enrichment pulls emails and person names. JSON output. Pay per place.", "version": "0.1", "x-build-id": "HsZk6FZg0eQxGhZtv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-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/scrapemint~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-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/scrapemint~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Queries to run on Google Maps. Examples: \"coffee shops in Austin\", \"dentist 78704\", \"plumbers near Miami\".", "default": [ "coffee shops in Austin TX" ], "items": { "type": "string" } }, "startUrls": { "title": "Direct place URLs", "type": "array", "description": "Direct Google Maps place URLs to scrape without running a search. Example: https://www.google.com/maps/place/.../@...", "default": [], "items": { "type": "string" } }, "language": { "title": "Language code", "type": "string", "description": "Google Maps UI language. Affects review translation and address format.", "default": "en" }, "maxPlacesPerQuery": { "title": "Max places per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on places returned per search query.", "default": 10 }, "maxPlacesTotal": { "title": "Max places per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on places extracted per run. Controls total cost.", "default": 20 }, "scrapeReviews": { "title": "Scrape reviews", "type": "boolean", "description": "Open each place and scroll the reviews panel. Off by default because it roughly triples run time (38.5s vs 10.7s measured on the same query) while the actor bills per place, not per review. Turn it on when you need review text.", "default": false }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 0, "maximum": 500, "type": "integer", "description": "Reviews per place cap. 0 skips reviews.", "default": 5 }, "scrapeImages": { "title": "Scrape images", "type": "boolean", "description": "Extract image URLs from each place.", "default": false }, "maxImagesPerPlace": { "title": "Max images per place", "minimum": 0, "maximum": 50, "type": "integer", "description": "Image URLs per place cap.", "default": 5 }, "enrichFromWebsite": { "title": "Enrich from business website", "type": "boolean", "description": "Visit the business website and pull emails and person names with job titles. Adds 5 to 10 seconds per place.", "default": false }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip place IDs returned by your previous runs. Off by default: with it on, a repeat run on the same query can return zero places (measured 0 rows vs 6 for the identical query with it off), which looks like a broken run. Turn it on when you only want places you have not seen before, and expect empty runs.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Residential strongly recommended. Google blocks datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }