{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper | Leads, Emails & Phones", "description": "Fast Google Maps scraper for whole-city business leads. Extract names, addresses, phones, websites, ratings, hours and place IDs; optionally find public emails, social profiles and sales signals. Search by city, category, postal code or coordinates. Export CSV, Excel or JSON. No Google API key.", "version": "0.2", "x-build-id": "AiD4sl2JqS49jfbz7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-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/apivault_labs~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-apivault_labs-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/apivault_labs~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-apivault_labs-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": { "country": { "title": "Country", "type": "string", "description": "Country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Scopes the city lookup and localizes Google results.", "default": "us" }, "city": { "title": "City", "type": "string", "description": "City to collect, for example `Chicago`, `Toronto`, or `Berlin`. Leave empty when using coordinates or a bounding box." }, "state": { "title": "State / region (optional)", "type": "string", "description": "Narrows the city lookup, e.g. 'Illinois' for Springfield." }, "postalCode": { "title": "Postal / ZIP code (optional)", "type": "string", "description": "Target a single postal code instead of a whole city." }, "categories": { "title": "Search terms / business categories", "type": "array", "description": "Select one or more common business categories. Each selected category expands city coverage and can increase the number of results.", "items": { "type": "string", "enum": [ "restaurant", "cafe", "bar", "bakery", "fast food restaurant", "pizza restaurant", "hotel", "motel", "dentist", "doctor", "medical clinic", "pharmacy", "chiropractor", "physiotherapist", "psychologist", "veterinarian", "hair salon", "barber shop", "beauty salon", "nail salon", "spa", "massage therapist", "fitness center", "gym", "plumber", "electrician", "HVAC contractor", "roofing contractor", "general contractor", "painter", "landscaper", "cleaning service", "pest control service", "locksmith", "auto repair shop", "car dealer", "used car dealer", "tire shop", "auto body shop", "car wash", "towing service", "car rental agency", "real estate agency", "property management company", "mortgage broker", "insurance agency", "lawyer", "accountant", "tax preparation service", "financial advisor", "marketing agency", "advertising agency", "web design company", "software company", "IT support service", "business consultant", "employment agency", "coworking space", "retail store", "clothing store", "furniture store", "electronics store", "hardware store", "florist", "jewelry store", "pet store", "school", "day care center", "driving school", "photographer", "event planner", "wedding venue", "travel agency", "moving company" ], "enumTitles": [ "Restaurants", "Cafes", "Bars", "Bakeries", "Fast food", "Pizza restaurants", "Hotels", "Motels", "Dentists", "Doctors", "Medical clinics", "Pharmacies", "Chiropractors", "Physiotherapists", "Psychologists", "Veterinarians", "Hair salons", "Barber shops", "Beauty salons", "Nail salons", "Spas", "Massage therapists", "Fitness centers", "Gyms", "Plumbers", "Electricians", "HVAC contractors", "Roofing contractors", "General contractors", "Painters", "Landscapers", "Cleaning services", "Pest control", "Locksmiths", "Auto repair shops", "Car dealers", "Used car dealers", "Tire shops", "Auto body shops", "Car washes", "Towing services", "Car rental agencies", "Real estate agencies", "Property management", "Mortgage brokers", "Insurance agencies", "Lawyers", "Accountants", "Tax preparation", "Financial advisors", "Marketing agencies", "Advertising agencies", "Web design companies", "Software companies", "IT support", "Business consultants", "Employment agencies", "Coworking spaces", "Retail stores", "Clothing stores", "Furniture stores", "Electronics stores", "Hardware stores", "Florists", "Jewelry stores", "Pet stores", "Schools", "Day care centers", "Driving schools", "Photographers", "Event planners", "Wedding venues", "Travel agencies", "Moving companies" ] }, "default": [ "restaurant", "cafe", "bar", "bakery", "fast food restaurant", "pizza restaurant", "hotel", "motel", "dentist", "doctor", "medical clinic", "pharmacy", "chiropractor", "physiotherapist", "psychologist", "veterinarian", "hair salon", "barber shop", "beauty salon", "nail salon", "spa", "massage therapist", "fitness center", "gym", "plumber", "electrician", "HVAC contractor", "roofing contractor", "general contractor", "painter", "landscaper", "cleaning service", "pest control service", "locksmith", "auto repair shop", "car dealer", "used car dealer", "tire shop", "auto body shop", "car wash", "towing service", "car rental agency", "real estate agency", "property management company", "mortgage broker", "insurance agency", "lawyer", "accountant", "tax preparation service", "financial advisor", "marketing agency", "advertising agency", "web design company", "software company", "IT support service", "business consultant", "employment agency", "coworking space", "retail store", "clothing store", "furniture store", "electronics store", "hardware store", "florist", "jewelry store", "pet store", "school", "day care center", "driving school", "photographer", "event planner", "wedding venue", "travel agency", "moving company" ] }, "customSearchTerms": { "title": "Custom search terms (optional)", "type": "array", "description": "Add categories or niche search phrases that are not available in the list above.", "items": { "type": "string" } }, "websiteFilter": { "title": "Website", "enum": [ "any", "without", "with" ], "type": "string", "description": "Keep all businesses, only those WITHOUT a website, or only those WITH one.", "default": "any" }, "requirePhone": { "title": "Only businesses with a phone", "type": "boolean", "description": "Keep only leads that expose a public phone number.", "default": false }, "onlyNoBooking": { "title": "Only businesses without online booking", "type": "boolean", "description": "Keep only businesses with no booking system (no Reserve with Google, no third-party platform).", "default": false }, "openNowOnly": { "title": "Only businesses open now", "type": "boolean", "description": "Keep only places Google currently marks as open. Places with unknown opening status are excluded.", "default": false }, "skipClosedPlaces": { "title": "Skip closed businesses", "type": "boolean", "description": "Exclude businesses Google marks with a closed status.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Keep only businesses rated at or above this (1-5). Unrated businesses are excluded when set." }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Keep only businesses rated at or below this (1-5) — find reputation problems to fix." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Keep only businesses with at least this many Google reviews. Unreviewed businesses are excluded when set." }, "maxReviews": { "title": "Maximum review count", "minimum": 0, "type": "integer", "description": "Keep only businesses with no more than this many Google reviews. Leave empty or zero for no upper limit." }, "nameFilter": { "title": "Business name filter", "type": "string", "description": "Optional text to match against the business name, for example 'Hilton' or 'McDonald’s'." }, "nameMatching": { "title": "Business name matching", "enum": [ "includes", "exact" ], "type": "string", "description": "Match the name exactly or keep names containing the filter text.", "default": "includes" }, "googleCategoryFilter": { "title": "Filter by Google's own category (optional)", "type": "array", "description": "Keep only businesses whose Google category contains any of these words, e.g. 'pizza'.", "items": { "type": "string" } }, "enrich": { "title": "Enrich leads (email, socials, buy-intent signals)", "type": "boolean", "description": "Visit each business website to pull the best email, socials, CMS, and website problems (no HTTPS, expired SSL, no mobile, outdated CMS, no booking, hiring). Adds a priority score and a suggested offer, and sorts highest-intent first. Slower.", "default": false }, "enrichmentMode": { "title": "Enrichment depth", "enum": [ "contacts", "full" ], "type": "string", "description": "Fast contacts finds email and social profiles with high parallelism. Full website audit also checks CMS, SSL, mobile readiness, speed, booking, and hiring signals.", "default": "contacts" }, "verifyEmails": { "title": "Verify emails", "type": "boolean", "description": "Drop malformed, disposable, and no-DNS addresses so what you get is mailable. Requires enrichment.", "default": false }, "requireEmail": { "title": "Only leads with an email", "type": "boolean", "description": "Keep only leads where an email was found. Requires enrichment.", "default": false }, "minPriorityScore": { "title": "Minimum priority score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only leads scoring at or above this (0-100). Requires enrichment." }, "trackChanges": { "title": "Track changes across runs (monitor mode)", "type": "boolean", "description": "Remember businesses between runs and tag each lead new / changed / unchanged (with first-seen / last-seen). Ideal on a schedule.", "default": false }, "onlyFresh": { "title": "Only fresh leads (new or changed)", "type": "boolean", "description": "With monitor mode on, return only leads new or changed since the last run. Ignored if monitor mode is off.", "default": false }, "maxResults": { "title": "Maximum places to extract", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Safety cap applied before website/email enrichment. Filters such as Only leads with an email, verified email, minimum score, website, phone, rating, or fresh-only monitoring can reduce the final number of Dataset rows below this value.", "default": 5000 }, "fastMode": { "title": "Fast mode", "type": "boolean", "description": "Return a quick sample for validation and lightweight workflows. Use standard mode for broader coverage.", "default": false }, "concurrency": { "title": "Google Maps search workers", "minimum": 1, "maximum": 500, "type": "integer", "description": "Parallel workers used to discover businesses. Default 250 is recommended. Increase only when your proxy pool and Actor memory can support it.", "default": 250 }, "enrichmentConcurrency": { "title": "Website and email workers", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Parallel website checks used when contact enrichment is enabled. Default 500 is optimized for Fast contacts. Full website audit is automatically capped at 100.", "default": 500 }, "deepContactPages": { "title": "Search contact and about pages", "type": "boolean", "description": "When the homepage has no email, inspect likely contact and about pages. Improves email coverage but makes enrichment slower.", "default": false }, "language": { "title": "Results language (optional)", "type": "string", "description": "Language code for result labels (e.g. 'en', 'de'). Empty = the country's own language." }, "lat": { "title": "Custom center latitude (advanced)", "type": "string", "description": "Center latitude. Example: `41.8781`. To search by coordinates, also provide Longitude and Area span. Coordinates override City." }, "lng": { "title": "Custom center longitude (advanced)", "type": "string", "description": "Center longitude. Example: `-87.6298`. Used together with Latitude and Area span." }, "span": { "title": "Area span in degrees (advanced)", "type": "string", "description": "Area width in degrees around the center. Example: `0.20` is roughly a medium-sized city area. Used only with custom coordinates." }, "north": { "title": "Bounding box north (advanced)", "type": "number", "description": "Northern edge. Set north, south, east and west together to define an exact rectangle. The bounding box overrides both city and center coordinates." }, "south": { "title": "Bounding box south (advanced)", "type": "number", "description": "Southern latitude." }, "east": { "title": "Bounding box east (advanced)", "type": "number", "description": "Eastern longitude. Dateline-crossing boxes are not supported." }, "west": { "title": "Bounding box west (advanced)", "type": "number", "description": "Western longitude." } } }, "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 } } } } } } } } } }