{ "openapi": "3.0.1", "info": { "title": "Google Maps enriched leads scraper", "description": "Find qualified local B2B leads on Google Maps: phone, website, ratings, hours, and optional email/tech enrichment. Lead scores, sales presets, and 4 pricing tiers from fast mode to enterprise.", "version": "1.0", "x-build-id": "AcmNGbHjFaZYjhGak" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burtonzach~google-maps-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burtonzach-google-maps-leads-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/burtonzach~google-maps-leads-scraper/runs": { "post": { "operationId": "runs-sync-burtonzach-google-maps-leads-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/burtonzach~google-maps-leads-scraper/run-sync": { "post": { "operationId": "run-sync-burtonzach-google-maps-leads-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", "required": [ "searchQueries", "location" ], "properties": { "searchQueries": { "title": "Search queries", "minItems": 1, "type": "array", "description": "Business types or keywords (e.g. dentist, plumber, HVAC).", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region, or address to center the search." }, "searchRadius": { "title": "Search radius", "minimum": 0, "maximum": 100, "type": "number", "description": "Search the surrounding area from your location center. Leave at 0 to search only the center point. Max 100 km or 62 mi.", "default": 0 }, "searchRadiusInMiles": { "title": "mi", "type": "boolean", "description": "Radius unit toggle — off = kilometers, on = miles.", "default": false }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 150, "type": "integer", "description": "How many businesses to collect per search query (max 150 per search).", "default": 25 }, "tier": { "title": "Pricing tier", "enum": [ "basic", "standard", "premium", "enterprise" ], "type": "string", "description": "Basic = rating & category. Standard = + phone, website, address. Premium = + email, tech & scores. Enterprise = Premium + residential proxies.", "default": "basic" }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "pt", "it", "nl", "pl", "ja", "ko", "zh-CN" ], "type": "string", "description": "Google Maps interface language for search results.", "default": "en" }, "proxyCountryCode": { "title": "Proxy country", "type": "string", "description": "Optional two-letter country code for Apify proxy geolocation (e.g. US, GB)." }, "deduplicateAcrossRuns": { "title": "Skip leads from previous runs", "type": "boolean", "description": "Remember businesses you already saved and skip them on future runs. History is stored in your Apify account Key-Value Store (not shared with other users).", "default": false }, "deduplicationStoreName": { "title": "Deduplication store name", "type": "string", "description": "Named Key-Value Store for your deduplication history. Use the same name on every run. Share this name with teammates who should use the same skip list." }, "resetDeduplicationStore": { "title": "Reset deduplication history", "type": "boolean", "description": "Clear saved business IDs before this run starts. Leads saved in this run are still added to the store for the next run.", "default": false }, "leadPreset": { "title": "Lead preset", "enum": [ "none", "low_reviews", "high_ratings", "local_service_businesses", "independent_businesses", "franchises", "missing_website", "high_quality_leads", "missing_email", "missing_social_media", "ecommerce_businesses" ], "type": "string", "description": "Quick filter bundles. Presets marked Premium/Standard in the label require that tier or higher.", "default": "none" }, "minRating": { "title": "Minimum rating (1-5)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Lowest Google star rating to include. Use 0 for no minimum.", "default": 0 }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Minimum number of Google reviews required.", "default": 0 }, "maxReviews": { "title": "Maximum reviews", "minimum": 0, "type": "integer", "description": "Maximum number of reviews. Useful for finding newer businesses." }, "categoryIncludes": { "title": "Include categories", "type": "array", "description": "Only keep businesses whose category matches any of these terms.", "items": { "type": "string" } }, "categoryExcludes": { "title": "Exclude categories", "type": "array", "description": "Remove businesses whose category matches any of these terms.", "items": { "type": "string" } }, "businessOwnership": { "title": "Business ownership", "enum": [ "any", "independent", "franchise" ], "type": "string", "description": "Filter by independent businesses vs franchise chains.", "default": "any" }, "requirePhone": { "title": "Require phone", "type": "boolean", "description": "Only businesses with a phone number on Google Maps.", "default": false }, "requireWebsite": { "title": "Require website", "type": "boolean", "description": "Only businesses with a website listed on Google Maps.", "default": false }, "minLeadScore": { "title": "Minimum lead score (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Composite lead quality score from website enrichment.", "default": 0 }, "minContactCompletenessScore": { "title": "Minimum contact completeness (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "How complete the business contact profile is.", "default": 0 }, "minWebsiteQualityScore": { "title": "Minimum website quality (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Website technical and UX quality score.", "default": 0 }, "requiredBadges": { "title": "Required badges", "type": "array", "description": "Business must have all selected badges.", "items": { "type": "string", "enum": [ "Has Email", "Contact Form", "Social Media", "Ecommerce", "SSL", "Booking System", "Live Chat", "Mobile Friendly" ] } }, "onlyOpportunities": { "title": "Sales opportunities", "type": "array", "description": "Only include leads with these sales opportunities.", "items": { "type": "string", "enum": [ "no_website", "outdated_website", "no_ssl", "no_booking", "no_social", "no_email" ], "enumTitles": [ "No website", "Outdated website", "No SSL", "No booking system", "No social media", "No email" ] } }, "requireEmail": { "title": "Require email", "type": "boolean", "description": "Business must have an email found on their website.", "default": false }, "requireContactForm": { "title": "Require contact form", "type": "boolean", "description": "Website must have a contact form.", "default": false }, "requireSocialProfiles": { "title": "Require social profiles", "type": "boolean", "description": "Business must have social media links on their website.", "default": false }, "requireSsl": { "title": "Require SSL (HTTPS)", "type": "boolean", "description": "Website must use HTTPS.", "default": false }, "requireMobileFriendly": { "title": "Require mobile-friendly signals", "type": "boolean", "description": "Website must show mobile-friendly signals.", "default": false }, "requireBooking": { "title": "Require booking system", "type": "boolean", "description": "Website must have online booking.", "default": false }, "requireEcommerce": { "title": "Require ecommerce signals", "type": "boolean", "description": "Website must show ecommerce capability.", "default": false }, "technologyIncludes": { "title": "Website technologies", "type": "array", "description": "Only include businesses whose website uses any of these technologies (e.g. Shopify, WordPress).", "items": { "type": "string" } } } }, "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 } } } } } } } } } }