{ "openapi": "3.0.1", "info": { "title": "Google Maps Places Scraper", "description": "Scrape Google Maps places by text, nearby or radius search, plus place details. Extract name, category, rating, reviews count, phone, website, address, coordinates and hours. Keywords, coordinates or place IDs in. Pay per result.", "version": "1.0", "x-build-id": "iahqipsB4j1c7NqN5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jdtpnjtp~google-maps-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jdtpnjtp-google-maps-places-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/jdtpnjtp~google-maps-places-scraper/runs": { "post": { "operationId": "runs-sync-jdtpnjtp-google-maps-places-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/jdtpnjtp~google-maps-places-scraper/run-sync": { "post": { "operationId": "run-sync-jdtpnjtp-google-maps-places-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", "uniqueItems": true, "type": "array", "description": "Keyword searches (e.g. `coffee`, `italian restaurants`, `dentist`). Each query is run with the search type and center below and returns matching places. Optional if you provide Place identifiers.", "items": { "type": "string" } }, "placeIds": { "title": "Place identifiers", "uniqueItems": true, "type": "array", "description": "Resolve specific places to full detail. Each item can be a place name, a Google Maps URL, a place_id (ChIJ...), a feature id (0x...:0x...), a numeric CID, or `lat,lng` coordinates. Each returns one full place-details row.", "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "text", "nearby", "radius" ], "type": "string", "description": "How keyword searches run. Text = map search centered on the coordinates below. Nearby = places around a point. Radius = places within a distance of a point.", "default": "text" }, "latitude": { "title": "Center latitude", "type": "string", "description": "Latitude of the search center (e.g. 40.7128). Required for Nearby and Radius search; optional for Text (defaults near New York - put the city in your query for other locations)." }, "longitude": { "title": "Center longitude", "type": "string", "description": "Longitude of the search center (e.g. -74.0060). Required for Nearby and Radius search." }, "radiusMeters": { "title": "Radius (meters)", "minimum": 50, "maximum": 200000, "type": "integer", "description": "Search radius in meters for Radius search (50 to 200000).", "default": 1000 }, "zoom": { "title": "Map zoom", "minimum": 1, "maximum": 21, "type": "integer", "description": "Map zoom for Text / Nearby search (13 = city, 15 = neighborhood, 17 = street).", "default": 14 }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper bound on places returned per search query (1 to 100). 20 = quick sample, 60 = solid dataset.", "default": 20 }, "includePlaceDetails": { "title": "Fan out search results to full place detail", "type": "boolean", "description": "When on, every place from a search row is enriched with a second call pulling its full place page (address, hours, attributes, owner info). This adds a place-details charge per result on top of the listing event. Leave off for a fast, cheap listing-only run.", "default": false }, "ratingMin": { "title": "Minimum rating", "enum": [ "", "2.0", "2.5", "3.0", "3.5", "4.0", "4.5" ], "type": "string", "description": "Keep only places at or above this average rating (text search only).", "default": "" }, "priceLevel": { "title": "Price level", "enum": [ "", "$", "$$", "$$$", "$$$$" ], "type": "string", "description": "Keep only places at this price level (text search only).", "default": "" }, "openNow": { "title": "Open now only", "type": "boolean", "description": "Keep only places open right now (text search, best-effort).", "default": false } } }, "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 } } } } } } } } } }