{ "openapi": "3.0.1", "info": { "title": "Google Maps Business Scraper | $1 per 1,000", "description": "Scrape unique Google Maps business listings by city, region, or country. Export names, addresses, phones, websites, ratings, review counts, opening hours, photos, and coordinates. Fast, API-ready, and priced at $1 per 1,000 successful results.", "version": "1.0", "x-build-id": "Ulnx1iQoeFYz1XO3Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~actor-google-maps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-actor-google-maps", "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/datascraperes~actor-google-maps/runs": { "post": { "operationId": "runs-sync-datascraperes-actor-google-maps", "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/datascraperes~actor-google-maps/run-sync": { "post": { "operationId": "run-sync-datascraperes-actor-google-maps", "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": [ "locations", "queries", "language", "countryCode" ], "properties": { "locations": { "title": "Locations", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Cities, regions, or countries to search, one per line. For the widest coverage and highest potential number of results, enter the country name itself (for example Spain) and select its matching country code. Country-wide searches usually take longer and can cost more; maxResults remains the global limit.", "items": { "type": "string", "minLength": 1 } }, "queries": { "title": "Search Queries", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Search terms to use on Google Maps (e.g. restaurants, dentists, hotels). Each query runs in every location.", "items": { "type": "string", "minLength": 1 } }, "language": { "title": "Language", "enum": [ "es", "en", "pt", "fr", "de", "it", "zh", "ja", "ko", "hi", "ar", "ru", "id", "tr", "nl", "pl", "vi", "th", "uk", "he", "af", "am", "az", "be", "bg", "bn", "bs", "ca", "cs", "cy", "da", "el", "et", "eu", "fa", "fi", "fil", "ga", "gl", "gu", "ha", "hr", "hu", "hy", "ig", "is", "jv", "ka", "kk", "km", "kn", "ku", "ky", "lb", "lo", "lt", "lv", "mg", "mi", "mk", "ml", "mn", "mr", "ms", "mt", "my", "nb", "ne", "nn", "no", "ny", "or", "pa", "ps", "ro", "rw", "sd", "si", "sk", "sl", "sm", "sn", "so", "sq", "sr", "st", "su", "sv", "sw", "ta", "te", "tg", "tk", "tl", "tt", "ur", "uz", "xh", "yo", "zu" ], "type": "string", "description": "Language Google Maps uses to return results. Choose from 100 commonly used languages. Applied to all locations in this run.", "default": "es" }, "countryCode": { "title": "Country code", "enum": [ "ES", "US", "GB", "DE", "FR", "IT", "PT", "BR", "MX", "CA", "AU", "IN", "JP", "CN", "KR", "ID", "NL", "PL", "TR", "SA", "AE", "CH", "AT", "BE", "SE", "NO", "DK", "FI", "IE", "CZ", "RO", "GR", "HU", "UA", "RU", "ZA", "EG", "NG", "KE", "MA", "DZ", "GH", "TN", "ET", "TZ", "UG", "SN", "CI", "CM", "AO", "MZ", "ZM", "ZW", "BW", "NA", "RW", "IL", "JO", "LB", "QA", "KW", "OM", "BH", "IQ", "PK", "BD", "LK", "NP", "TH", "VN", "MY", "SG", "PH", "NZ", "AR", "CL", "CO", "PE", "VE", "EC", "UY", "PY", "BO", "CR", "PA", "GT", "DO", "HN", "SV", "NI", "JM", "TT", "CU", "KZ", "UZ", "AZ", "GE", "AM", "RS", "HR" ], "type": "string", "description": "Country used to disambiguate and constrain every location. Choose from 100 commonly searched countries and markets.", "default": "ES" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of unique businesses written to the dataset across all locations and queries. Each successful result costs $0.001. Set to 0 for unlimited and use Apify's Maximum cost per run option as a safety cap.", "default": 1000 } } }, "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 } } } } } } } } } }