{ "openapi": "3.0.1", "info": { "title": "Instant Google Maps Scraper", "description": "Scrape businesses from Google Maps: name, phone, website, address, coordinates, category, rating, reviews and hours. Filter places with or without a website. $0.75 per 1,000 places; leads without a website $1.25 per 1,000.", "version": "1.0", "x-build-id": "eXzpWfM5gaTRoWfGD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bhavani_siva~instant-google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bhavani_siva-instant-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/bhavani_siva~instant-google-maps-scraper/runs": { "post": { "operationId": "runs-sync-bhavani_siva-instant-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/bhavani_siva~instant-google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-bhavani_siva-instant-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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type into Google Maps, e.g. 'dentist', 'pool builder', 'pizza'.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "City, ZIP code, county or neighborhood. Every search term runs in every location ('dentist in Austin, TX'). Leave empty to search the terms exactly as typed.", "items": { "type": "string" } }, "maxPlaces": { "title": "Max places in total", "minimum": 1, "type": "integer", "description": "The run stops after this many unique places. You pay only for places delivered. If the area has fewer, you get all of them.", "default": 1000 }, "deepSearch": { "title": "Deep search (all places in the area)", "type": "boolean", "description": "One Google Maps search shows at most about 120-200 places. When a location has more, the actor splits its area (city, state or whole country) into map cells and searches each one, so you get every place Google has there, up to your max places. Turn off for just the top results of each search (faster).", "default": true }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "pl", "sv", "da", "fi", "no", "cs", "tr", "ja", "ko", "zh-CN", "ar", "hi" ], "type": "string", "description": "Language of categories, descriptions and opening hours.", "default": "en" }, "countryCode": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter country code of the area you search (us, gb, ca, au, de...). Used as Google's region.", "default": "us" }, "categoryFilter": { "title": "Only keep categories containing", "type": "array", "description": "Keep a place only if one of its Google categories contains one of these words, e.g. 'pool' keeps 'Swimming pool contractor'. Filtered places are free.", "items": { "type": "string" } }, "skipClosed": { "title": "Skip permanently closed places", "type": "boolean", "description": "Permanently closed places are not delivered (and not charged).", "default": true }, "websiteFilter": { "title": "Website", "enum": [ "all", "withWebsite", "withoutWebsite" ], "type": "string", "description": "Places without a website are good leads for web design and marketing. A Facebook or Instagram page listed as the website counts as a website. Only places without a website costs $0.50 more per 1,000 ($1.25 per 1,000 in total).", "default": "all" }, "onlyWithPhone": { "title": "Only places with a phone number", "type": "boolean", "description": "Skip places that list no phone number.", "default": false }, "areas": { "title": "Map areas (full coverage)", "type": "array", "description": "Search a circle cell by cell to get past the per-search limit. Each area: {\"name\": \"Dallas\", \"lat\": 32.78, \"lng\": -96.8, \"radiusKm\": 20}. Optional \"cellKm\" (default 5): smaller cells find more places in dense areas but take longer. Places outside the circle are skipped. Every search term runs in every area." } } }, "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 } } } } } } } } } }