{ "openapi": "3.0.1", "info": { "title": "Google Maps Extractor - Business Leads, Phones & Websites", "description": "Extract business leads from Google Maps for any search and location: name, phone, website, address, rating, reviews, categories, opening hours and coordinates. An optional website visit adds emails and social media links. $1 per 1,000 places; filters, empty searches and failures are free.", "version": "1.0", "x-build-id": "E1AYzYGBm9XlkgPnY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~google-maps-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-google-maps-extractor", "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/tenfoldfleet~google-maps-extractor/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-google-maps-extractor", "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/tenfoldfleet~google-maps-extractor/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-google-maps-extractor", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "What to search for", "type": "array", "description": "Business types or keywords, as you would type them into Google Maps: \"dentist\", \"plumber\", \"coffee shop\", \"car dealer\". Every query is searched in every location below.", "items": { "type": "string" } }, "locations": { "title": "Where to search", "type": "array", "description": "Cities, regions or zip codes, e.g. \"Austin, TX\", \"Manchester, UK\", \"10115 Berlin\" or \"78704\". The search sent to Google is \" in \". Leave it empty only if your queries already name the place (\"dentist in Austin, TX\"); otherwise Google returns places near the server, in the USA. Google lists up to about 250-300 places per search, so split a big city into zip codes or neighborhoods to get more.", "items": { "type": "string" } }, "maxPlacesPerSearch": { "title": "Max places per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many places to return for each query + location pair. Google itself ends a search after about 250-300 places, fewer in small towns.", "default": 100 }, "maxItems": { "title": "Max places in total", "minimum": 0, "type": "integer", "description": "Stop after this many places across all searches (0 = no limit). You can also cap the cost with the run's maximum charge. On the Apify free plan, the $5 monthly credit covers about 4,900 places.", "default": 0 }, "language": { "title": "Language", "type": "string", "description": "Language of category names and opening hours, as a code: en, de, fr, es, pt-BR, ...", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code that Google uses as the search region: us, gb, de, ca, au, ... The location text decides where results come from; this only fine-tunes it.", "default": "us" }, "minRating": { "title": "Minimum rating", "enum": [ "0", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Only places with at least this Google rating. Filters are free: places that don't pass are skipped and never charged.", "default": "0" }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Only places with at least this many Google reviews (0 = any).", "default": 0 }, "requirePhone": { "title": "Only places with a phone number", "type": "boolean", "description": "Skip places without a phone number on Google Maps.", "default": false }, "requireWebsite": { "title": "Only places with a website", "type": "boolean", "description": "Skip places without a website on Google Maps.", "default": false }, "skipClosed": { "title": "Skip closed businesses", "type": "boolean", "description": "Skip places that Google marks as permanently or temporarily closed.", "default": true }, "enrichContacts": { "title": "Find emails and social profiles on each website", "type": "boolean", "description": "Visit each business website (homepage plus up to 2 contact pages) and add emails, Facebook, Instagram, LinkedIn, X, YouTube and TikTok links. The contact fee is charged only for places where at least one email or social profile is found. Makes the run slower.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The default (Apify datacenter proxy, US) works. If Google blocks a request, the actor retries on a new IP and then through residential proxy at no extra cost to you.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }