{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper | Apify Actor for Extracting Business Data", "description": "Only $0.004/business Scraped. Effortlessly Scrape Google Maps for business listings, including name, phone, address, website, ratings, reviews, hours, and photos. Ideal for lead generation, local SEO, and market research. Supports geolocation, pagination, and multilingual searches.", "version": "0.0", "x-build-id": "CfXC6gN5jD6zjDwc1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yasir-on-apify~google-maps-scraper-apify-actor-for-extracting-business-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yasir-on-apify-google-maps-scraper-apify-actor-for-extracting-business-data", "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/yasir-on-apify~google-maps-scraper-apify-actor-for-extracting-business-data/runs": { "post": { "operationId": "runs-sync-yasir-on-apify-google-maps-scraper-apify-actor-for-extracting-business-data", "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/yasir-on-apify~google-maps-scraper-apify-actor-for-extracting-business-data/run-sync": { "post": { "operationId": "run-sync-yasir-on-apify-google-maps-scraper-apify-actor-for-extracting-business-data", "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": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "The search term to **scrape Google Maps** for businesses. Use natural language like 'coffee shops in New York', 'dentists near me', or 'restaurants in London' to extract phone numbers, addresses, and reviews." }, "limit": { "title": "Results Limit", "minimum": 1, "maximum": 500, "type": "integer", "description": "The number of business listings to fetch per run. Up to 500 results. Ideal for **lead generation**, **local SEO research**, or **scraping Google Maps in bulk**." }, "country": { "title": "Country", "enum": [ "us", "gb", "de", "fr", "it", "au", "ca", "br", "jp", "in", "mx", "nl", "se", "ch", "kr", "ru", "cn", "za", "ar", "at", "be", "bg", "bh", "by", "cl", "co", "hr", "cz", "dk", "do", "ee", "fi", "gr", "gt", "hk", "hu", "id", "ie", "il", "is", "kz", "kw", "lb", "lt", "lu", "lv", "my", "ng", "no", "pa", "pe", "ph", "pk", "pl", "pt", "qa", "ro", "sa", "sg", "si", "sk", "tr", "tw", "ua", "uy", "ve", "vn", "af", "al", "dz", "ad", "ao", "ag", "am", "aw", "az", "bs", "bd", "bb", "bz", "bj", "bt", "bo", "ba", "bw", "bn", "bf", "bi", "kh", "cm", "cv", "cf", "td", "km", "cg", "cd", "cr", "cu", "cy", "dj", "dm", "ec", "eg", "sv", "gq", "er", "et", "fj", "ga", "gm", "ge", "gh", "gn", "gw", "gy", "ht", "hn", "im", "jm", "jo", "ke", "ki", "kp", "kg", "la", "ls", "lr", "ly", "li", "mo", "mk", "mg", "mw", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "mz", "na", "nc", "ne", "ni", "nr", "om", "pg", "py", "pr", "sb", "sc", "sd", "sh", "sl", "sm", "sn", "so", "sr", "ss", "st", "sy", "sz", "tc", "tf", "tg", "th", "tj", "tk", "tm", "tn", "to", "tt", "tv", "tz", "ug", "va", "vc", "wf", "ws", "ye", "zm", "zw", "gd", "fm", "md", "mc", "mn", "me", "ma", "np", "nz", "pw", "kn", "lc", "rs", "lk", "tl", "ae", "uz", "vu" ], "type": "string", "description": "The 2-letter country code to localize your **Google Maps search** (e.g., 'us', 'gb', 'de', 'au'). Ensures accurate business names, addresses, and phone numbers in the target region." }, "lang": { "title": "Language", "type": "string", "description": "The language code for results (e.g., 'en', 'fr', 'es', 'ja'). Use to **scrape Google Maps in any language** and get properly formatted business hours, reviews, and descriptions." }, "lat": { "title": "Latitude", "type": "number", "description": "Latitude coordinate to center your **Google Maps data extraction**. Use for hyper-local searches like 'gyms in Manhattan' or 'hotels near Eiffel Tower'. Leave empty for auto-centering." }, "lng": { "title": "Longitude", "type": "number", "description": "Longitude to pair with latitude. Enables **precise geolocation scraping** of businesses in a specific neighborhood or city center. Leave empty for dynamic location." }, "offset": { "title": "Offset", "type": "integer", "description": "Number of results to skip for pagination. Use with 'limit' to **scrape Google Maps in batches** (e.g., offset 100 = results 101–200). Great for large-scale data collection." }, "zoom": { "title": "Zoom Level", "type": "integer", "description": "Map zoom level (3–20) to control search radius. Higher values = smaller area. Use 15–18 for **precise local business scraping** in downtown districts or neighborhoods." } } }, "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 } } } } } } } } } }