{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "Scrape Google Maps business data at scale. Extract phone numbers, emails, reviews, ratings, addresses & more from thousands of locations. Enrich results with real-time emails and social links from business websites. Export instantly or automate via API.", "version": "0.0", "x-build-id": "OD7acRdqfysGwif5G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datarava~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datarava-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/datarava~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-datarava-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/datarava~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-datarava-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": [ "number_of_target_records", "search_term" ], "properties": { "search_term": { "title": "Enter one or multiple Search Terms: ", "type": "array", "description": "Provide the search terms to get data for. like Hotels, Restaurants, Libraries etc.", "items": { "type": "string" }, "default": [ "" ] }, "location": { "title": "Enter one or more Custom locations or choose a predefined Location from below: ", "type": "array", "description": "Provide your custom location to search in. like London, New York etc.", "items": { "type": "string" }, "default": [ "" ] }, "predefined_location": { "title": "Select a Predefined Location (if you want to use this, keep custom locations empty) : ", "enum": [ "None", "Australia", "Brazil", "Canada", "France", "Germany", "Hong Kong", "Indonesia", "Italy", "Japan", "Mexico", "Netherlands", "Singapore", "Spain", "Switzerland", "United Kingdom", "Complete USA", "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ], "type": "string", "description": "Select a country or a US state. If you want to use this predefined location then please keep the above manual location value to empty", "default": "None" }, "gps_coordinates": { "title": "GPS Coordinates", "type": "string", "description": "if GPS Coordinates are provided, Custom and predefined Locations feilds above will be ignored. Actor will get data from this custom location provided through GPS coordinates. The format of this field is lat,long,zoom_level. for example: 51.4980493,-0.2257851,12z. The zoom level starts from 3z to 21z. 3z means full zoom out and 21z means full zoom in. You can search your desired term in Google Maps. then you can find these coordinates in URL bar in this format @lat,long,zoom_level. You can provide these here for precise search. example: 51.4980493,-0.2257851,12z" }, "number_of_target_records": { "title": "Number of Places to extract (for all locations and search terms) :", "minimum": 20, "maximum": 100000, "type": "integer", "description": "Enter how many records do you want to get.", "default": 20 }, "enhanced_search": { "title": "Enrich records with Email and Social meida links from each Place's website", "type": "boolean", "description": "Scrape Email and Social meida links if available at corresponding record's website", "default": false }, "enrich_records_with_reviews": { "title": "Enrich each place with real reviews from Google Maps Listing", "type": "boolean", "description": "if enabled, Actor will get reviews from Google Maps for corresponding place.", "default": false }, "reviews_per_record": { "title": "Number of Reviews per Record", "minimum": 10, "maximum": 300, "type": "integer", "description": "Enter number of reviews that you want to get for each record. Actor will keep getting reviews till this number or till maximum available reviews for a single record.", "default": 10 }, "reviews_sort_type": { "title": "Sort Reviews By: ", "enum": [ "Most Relevant", "Newest", "Highest Rating", "Lowest Rating" ], "type": "string", "description": "How to sort total reviews before adding into each record.", "default": "Newest" } } }, "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 } } } } } } } } } }