{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "Scrape Google Maps places, reviews, and business leads at scale. No API keys. No login. No browser. Pure HTTP β€” fast, cheap, and reliable. Built for lead generation, local SEO research, competitor intelligence, and AI agents.", "version": "0.0", "x-build-id": "YnSHrsust686m4sXj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/labrat011~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-labrat011-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/labrat011~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-labrat011-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/labrat011~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-labrat011-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", "properties": { "keywords": { "title": "πŸ” Keywords", "type": "string", "description": "Business type, category, or keyword to search (e.g. 'coffee shops', 'dentists', 'plumbers near me'). Combined with Location to form the search query. Use Keywords List below for batch mode." }, "location": { "title": "πŸ“ Location", "type": "string", "description": "Where to search (e.g. 'Austin, TX', 'London, UK', '10001'). Free-text β€” accepts city, neighborhood, ZIP, or country. Use Locations List below for batch mode. Or use Custom Geolocation below for precise polygon targeting." }, "keywordsList": { "title": "πŸ“‹ Keywords List (Batch Mode)", "type": "array", "description": "Run many keyword searches in one job. Combined with every entry in Locations List β€” e.g. ['dentist', 'orthodontist'] Γ— ['Austin, TX', 'Dallas, TX'] = 4 searches, one run. Overrides the single Keywords field when provided.", "items": { "type": "string" } }, "locationsList": { "title": "πŸ—ΊοΈ Locations List (Batch Mode)", "type": "array", "description": "Multiple locations to search across in batch mode. Cross-multiplied with Keywords List. Leave empty or pass a single country to search broadly.", "items": { "type": "string" } }, "placeUrls": { "title": "πŸ”— Direct Place URLs", "type": "array", "description": "Skip search and scrape these Google Maps place URLs directly. Useful when you already have a list of businesses from a previous run, a spreadsheet, or the Places API.", "items": { "type": "string" } }, "customGeolocation": { "title": "🌐 Custom Geolocation (GeoJSON)", "type": "object", "description": "Optional GeoJSON Point or Polygon for precise area targeting. When provided, the scraper searches within the geometry instead of free-text location. Supports { \"type\": \"Point\", \"coordinates\": [lng, lat] } or { \"type\": \"Polygon\", \"coordinates\": [[[lng, lat], ...]] }." }, "language": { "title": "🌐 Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "pl", "ja", "zh-CN", "ko", "ru", "tr", "ar" ], "type": "string", "description": "Language code for Google Maps (ISO 639-1). Affects place names, categories, and reviews.", "default": "en" }, "countryCode": { "title": "🏳️ Country Code", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "br", "mx", "jp", "in", "za", "ae" ], "type": "string", "description": "Country code for Google Maps regional bias (ISO 3166-1 alpha-2, lowercase).", "default": "us" }, "minRating": { "title": "⭐ Minimum Rating", "enum": [ "0", "3", "4", "5" ], "type": "string", "description": "Only include places with at least this star rating.", "default": "0" }, "includeClosed": { "title": "🚫 Include Permanently Closed", "type": "boolean", "description": "When disabled, skips places marked permanently or temporarily closed on Google Maps.", "default": true }, "maxReviewsPerPlace": { "title": "πŸ’¬ Max Reviews per Place", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many reviews to extract for each place. Set to 0 to skip reviews entirely. Default 10 balances cost and signal.", "default": 10 }, "includeReviewSentiment": { "title": "πŸ“Š Include Review Sentiment", "type": "boolean", "description": "Adds a simple positive/neutral/negative breakdown based on review star ratings. No LLM cost β€” adds zero to your bill.", "default": true }, "reviewLanguage": { "title": "πŸ—£οΈ Review Language", "type": "string", "description": "Language code for reviews (ISO 639-1). Leave as 'en' for English.", "default": "en" }, "enrichDetails": { "title": "πŸ“‹ Enrich Place Details (Phone, Website, Hours, Images)", "type": "boolean", "description": "Visit each place's detail page to extract phone number, website, full opening hours, and photos. Adds ~8-10 seconds per place. Disabled by default β€” basic results (name, rating, category, address, coordinates) are extracted from the search page without this.", "default": false }, "enrichContacts": { "title": "πŸ“§ Enrich Contacts (Email + Social Profiles)", "type": "boolean", "description": "When enabled, fetches each place's website and extracts emails, Facebook, Instagram, Twitter/X, LinkedIn, YouTube, TikTok, and Pinterest profile URLs. Cached per unique website within the run.", "default": false }, "enrichLinkedIn": { "title": "πŸ”— Enrich with LinkedIn Search URL", "type": "boolean", "description": "Adds a ready-to-use LinkedIn company search URL to each result β€” feed it straight into labrat011/linkedin-jobs-scraper's companyFilter for full lead pipelines. Free.", "default": false }, "outputView": { "title": "πŸ“€ Output View", "enum": [ "places", "reviews", "leads" ], "type": "string", "description": "Pre-filter results for common use cases. 'places' returns full place records, 'reviews' focuses on review data, 'leads' returns only contact-ready fields.", "default": "places" }, "maxResults": { "title": "πŸ“Š Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum total places to return. Free users capped at 25. Subscribe for up to 10,000.", "default": 100 }, "maxResultsPerSearch": { "title": "πŸ”’ Max Results Per Search (Batch Mode)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap per keyword/location combination in batch mode. Example: 3 keywords Γ— 2 locations Γ— 20 per search = up to 120 total results.", "default": 100 }, "proxyConfiguration": { "title": "πŸ”’ Proxy Configuration", "type": "object", "description": "Proxy settings. RESIDENTIAL is required for reliable browser-based scraping. Do not use GOOGLE_SERP here β€” it only supports plain HTTP fetching (not HTTPS tunneling) and will fail Playwright navigation." } } }, "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 } } } } } } } } } }