{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper – Places, Phone, Website, Email & Hours", "description": "Extract business data from Google Maps by search query or coordinates: name, address, phone, website, rating, hours and more.", "version": "0.1", "x-build-id": "OHFVkJOlwIOPrlf0O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moyadata~google-maps-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moyadata-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/moyadata~google-maps-places-scraper/runs": { "post": { "operationId": "runs-sync-moyadata-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/moyadata~google-maps-places-scraper/run-sync": { "post": { "operationId": "run-sync-moyadata-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": { "queries": { "title": "Search queries", "type": "array", "description": "One or more Google Maps search queries, e.g. \"dentist in Austin, TX\". Max 700 characters each. Optional if both `categories` and `cities` below are set.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "ISO-2 country code the queries refer to (e.g. US, GB, CL, MX). It must match the country in your queries: a query like 'dentista en Providencia, Santiago' with country US returns places from the wrong country, with country CL it returns 100 dentists in Providencia. Ignored for location matching when coordinates is set, but still used to resolve the location for review requests.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code for the results, e.g. \"en\", \"es\". Also picks the categories x cities query template (see below).", "default": "en" }, "coordinates": { "title": "Coordinates (optional)", "type": "string", "description": "Anchor the search to a map viewport instead of a country: \"lat,lng,zoom\", e.g. \"30.2672,-97.7431,14\"." }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 700, "type": "integer", "description": "Maximum number of places to return per query (1-700).", "default": 20 }, "deduplicate": { "title": "Deduplicate places", "type": "boolean", "description": "Remove duplicate places (by placeId) seen across multiple queries in this run.", "default": true }, "categories": { "title": "Categories (bulk mode)", "type": "array", "description": "Business categories, e.g. \"dentist\", \"coffee shop\".", "items": { "type": "string" } }, "cities": { "title": "Cities (bulk mode)", "type": "array", "description": "Cities/areas to combine with `categories`, e.g. \"Austin, TX\".", "items": { "type": "string" } }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Fetch reviews for each place returned.", "default": false }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 10, "maximum": 100, "type": "integer", "description": "How many reviews to fetch per place when Include reviews is on (10-100; multiples of 10 recommended).", "default": 10 }, "reviewsSort": { "title": "Reviews sort order", "enum": [ "relevant", "newest", "highest_rating", "lowest_rating" ], "type": "string", "description": "Sort order requested from the reviews API.", "default": "newest" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only places with a rating >= this value (0-5). Places with no rating are excluded when this is set." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Keep only places with at least this many reviews. Places with no review count are excluded when this is set." }, "hasWebsite": { "title": "Has website", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Keep only places that have a website, only places without one, or both.", "default": "any" }, "hasPhone": { "title": "Has phone", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Keep only places that have a phone number, only places without one, or both.", "default": "any" }, "openNow": { "title": "Open now", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Keep only places open at scrape time, only closed ones, or both.", "default": "any" }, "categoriesInclude": { "title": "Categories include", "type": "array", "description": "Keep only places whose category or additional categories match one of these (case-insensitive, exact match).", "items": { "type": "string" } }, "enrichContacts": { "title": "Enrich contacts", "type": "boolean", "description": "Fetch emails and social links from each place's website.", "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 } } } } } } } } } }