{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper & Email Extractor – Business Leads", "description": "Google Maps scraper and email extractor for lead generation. Search any category in any city and get name, address, phone, website, rating and weekly hours, plus role emails, social profiles and WhatsApp from each business's own website. Free filters, and you pay only for the places returned.", "version": "0.1", "x-build-id": "SFcPRyusaoKdlvQgG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/locomint~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-locomint-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/locomint~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-locomint-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/locomint~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-locomint-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": { "searchStringsArray": { "title": "Search terms", "type": "array", "description": "What to look for - one or more categories or business names, e.g. \"dentist\", \"coffee shop\", \"car rental\". Each term is searched separately. Up to 25 per run.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "City, area or address. Always add the country for unambiguous results: \"Warsaw, Poland\" rather than \"Warsaw\"." }, "maxCrawledPlacesPerSearch": { "title": "Max places per search term", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit of places to collect for each search term. You are charged per place delivered. Large asks sweep the whole city automatically.", "default": 20 }, "placeIds": { "title": "Place IDs (instead of searching)", "type": "array", "description": "Already have a list? Paste place IDs (ChIJ... or 0x...:0x... feature IDs) and get the full record with enrichment for each - no search needed. Up to 1,000 per run.", "items": { "type": "string" } }, "placeMinimumStars": { "title": "Minimum rating", "enum": [ "", "2", "2.5", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Only deliver places rated at least this. Places without a rating are skipped. Free - filtered places are not charged.", "default": "" }, "websiteFilter": { "title": "Website", "enum": [ "any", "with", "without" ], "type": "string", "description": "Only places with a website (good for enrichment) or only places without one (good for web-design outreach).", "default": "any" }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Leave out places marked temporarily or permanently closed.", "default": false }, "categoryFilterWords": { "title": "Category must contain", "type": "array", "description": "Keep only places whose category contains at least one of these words, e.g. [\"dentist\", \"orthodontist\"]. Case-insensitive.", "items": { "type": "string" } }, "searchMatching": { "title": "Name matching", "enum": [ "all", "only_includes", "only_exact" ], "type": "string", "description": "Restrict results by how the place name relates to the search term. Useful when searching for a brand.", "default": "all" }, "includeNearbyPlaces": { "title": "Include nearby places", "type": "boolean", "description": "By default, results outside the resolved city area are dropped (they are usually a different place with the same name). Turn on to keep them.", "default": false }, "includeDetails": { "title": "Fetch full details", "type": "boolean", "description": "Adds description, weekly opening hours, plus code, timezone, photos and attributes for each place. Included in the price.", "default": true }, "includeEnrichment": { "title": "Enrich from the business website", "type": "boolean", "description": "Visits each business's own website to extract business emails, social profiles, WhatsApp, contact page and tech stack. Included in the price. Never collects personal data.", "default": true }, "outputFormat": { "title": "Row format", "enum": [ "full", "compact-for-ai" ], "type": "string", "description": "Full record gives every column. Compact for AI trims each row to the facts a model needs, adds a one-line text summary of the business and a citation (place ID, source, time read) so an answer can be traced back. Same reads, same price, fewer columns.", "default": "full" }, "language": { "title": "Language", "type": "string", "description": "BCP-47 language for names and categories (en, ar, de, ja, ...).", "default": "en" } } }, "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 } } } } } } } } } }