{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Generator", "description": "Find local businesses from Google Maps and turn them into AI-scored sales leads with emails, website insights, outreach angles, and CRM-ready exports. Export data, run via API, schedule and monitor runs, or integrate with other tools.", "version": "0.1", "x-build-id": "kSdnuZmQZhFYZXYa1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dvcontact~google-maps-lead-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dvcontact-google-maps-lead-generator", "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/dvcontact~google-maps-lead-generator/runs": { "post": { "operationId": "runs-sync-dvcontact-google-maps-lead-generator", "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/dvcontact~google-maps-lead-generator/run-sync": { "post": { "operationId": "run-sync-dvcontact-google-maps-lead-generator", "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": [ "maxResults", "servicesToSell" ], "properties": { "niche": { "title": "🎯 Preset niche", "enum": [ "dentists", "medspas", "roofers", "plumbers", "lawyers", "chiropractors", "gyms", "restaurants", "real estate agencies", "cleaning companies", "electricians", "hvac contractors", "landscapers", "pest control companies", "accountants", "insurance agencies", "auto repair shops", "veterinarians", "physical therapists", "home remodelers" ], "type": "string", "description": "Choose the type of local business to find. Example: Dentists, Roofers, or HVAC contractors. Use this for a quick search with the Location field. If you add custom Search terms or Google Maps URLs, those become the main search instructions.", "default": "dentists" }, "location": { "title": "📍 Location", "type": "string", "description": "Enter a city, metro area, state, region, or country. Example: Austin, Texas; Ontario, Canada; or Manchester, United Kingdom. City-level searches are usually faster and more focused. For custom search terms, include the location in each term." }, "countryCode": { "title": "🌎 Country", "enum": [ "US", "CN", "DE", "JP", "IN", "GB", "FR", "IT", "RU", "BR", "CA", "AU", "ES", "MX", "KR", "ID", "TR", "NL", "SA", "CH", "PL", "TW", "BE", "SE", "AR", "IE", "TH", "AT", "IL", "NO", "AE", "SG", "VN", "BD", "PH", "MY", "HK", "ZA", "DK", "CO", "EG", "PK", "CL", "RO", "CZ", "FI", "PT", "PE", "NZ", "GR" ], "type": "string", "description": "Choose the country used for Google Maps localization and exported country fields. Example: United States, Canada, Germany, or Nigeria. If the Location clearly includes a country, the Actor uses that location country.", "default": "US" }, "language": { "title": "🗣️ Language", "enum": [ "en", "fr", "de", "es", "it", "pt", "nl", "hi", "ar", "ja", "ko" ], "type": "string", "description": "Choose the language for Google Maps results and generated outreach. Example: English, French, German, or Spanish. Keep English if your campaign and recipients use English.", "default": "en" }, "maxResults": { "title": "🔢 Maximum number of records ($)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of business records to save. Start with 10–50 to test your search, then increase it for a campaign. Larger runs can take longer and cost more. Duplicate removal and filters may reduce the final count.", "default": 10 }, "servicesToSell": { "title": "💼 Services to sell", "type": "array", "description": "Choose the services you want to offer. These selections guide opportunity scoring and outreach. Example: SEO + Website redesign + Review generation. The Other recommended service field is an additional observed opportunity and does not replace your chosen offer.", "items": { "type": "string", "enum": [ "Accounting", "Admin support", "AI automation", "AI chatbot", "Appointment booking optimization", "Appointment setting", "Automation", "Blog writing", "Bookkeeping", "Branding", "Business card design", "Citation building", "Cold email outreach", "Content marketing", "Conversion rate optimization", "Copywriting", "CRM setup", "Customer reactivation", "Data entry", "Directory listings", "Ecommerce setup", "Email marketing", "Email setup", "Facebook Ads", "Flyer design", "General agency services", "GoHighLevel setup", "Google Ads", "Google Analytics setup", "Google Business Profile optimization", "Graphic design", "HubSpot setup", "Instagram Ads", "Landing pages", "Lead generation", "Live chat", "Local lead generation", "Local SEO", "Local sponsorship outreach", "Logo design", "Marketing automation", "Missed-call text back", "On-page SEO", "Online booking setup", "Pay-per-call lead generation", "Payment automation", "Photography", "Referral program setup", "Reputation management", "Reputation repair", "Review generation", "Review response management", "Sales development", "Sales pipeline setup", "SEO", "Shopify setup", "SMS marketing", "Social media management", "Technical SEO", "TikTok Ads", "Video marketing", "Virtual assistant", "Web design", "Website maintenance", "Website redesign", "Website speed optimization", "WordPress development", "Workflow automation", "YouTube Ads" ], "enumTitles": [ "Accounting", "Admin support", "AI automation", "AI chatbot", "Appointment booking optimization", "Appointment setting", "Automation", "Blog writing", "Bookkeeping", "Branding", "Business card design", "Citation building", "Cold email outreach", "Content marketing", "Conversion rate optimization", "Copywriting", "CRM setup", "Customer reactivation", "Data entry", "Directory listings", "Ecommerce setup", "Email marketing", "Email setup", "Facebook Ads", "Flyer design", "General agency services", "GoHighLevel setup", "Google Ads", "Google Analytics setup", "Google Business Profile optimization", "Graphic design", "HubSpot setup", "Instagram Ads", "Landing pages", "Lead generation", "Live chat", "Local lead generation", "Local SEO", "Local sponsorship outreach", "Logo design", "Marketing automation", "Missed-call text back", "On-page SEO", "Online booking setup", "Pay-per-call lead generation", "Payment automation", "Photography", "Referral program setup", "Reputation management", "Reputation repair", "Review generation", "Review response management", "Sales development", "Sales pipeline setup", "SEO", "Shopify setup", "SMS marketing", "Social media management", "Technical SEO", "TikTok Ads", "Video marketing", "Virtual assistant", "Web design", "Website maintenance", "Website redesign", "Website speed optimization", "WordPress development", "Workflow automation", "YouTube Ads" ] }, "default": [ "SEO" ] }, "excludeChains": { "title": "🏪 Enable chain and franchise filtering", "type": "boolean", "description": "Remove likely chains, franchises, and corporate location pages. Keep this enabled when targeting independent local businesses. Detection is heuristic, so a small number of chains may still appear.", "default": true }, "minimumRating": { "title": "⭐ Minimum rating filter", "minimum": 0, "maximum": 5, "type": "number", "description": "Return businesses at or above this Google rating. Example: 4.3 for established businesses with strong trust. Leave blank when rating should not limit the search." }, "maximumRating": { "title": "⭐ Maximum rating filter", "minimum": 0, "maximum": 5, "type": "number", "description": "Return businesses at or below this Google rating. Example: 4.2 for reputation management prospects. Leave blank when rating should not limit the search." }, "minimumReviewCount": { "title": "💬 Minimum review count filter", "minimum": 0, "type": "integer", "description": "Return businesses with at least this many Google reviews. Example: 20 to focus on established listings. Leave blank to include businesses with any review count." }, "websitePresenceFilter": { "title": "🌐 Website presence filter", "enum": [ "any", "with_website", "without_website" ], "type": "string", "description": "Choose Any, Only with websites, or Only without websites. Use with websites for email discovery and audits; use without websites for first-website offers.", "default": "any" }, "maxCrawledPlacesPerSearch": { "title": "Advanced record limit (legacy) ($)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Legacy API-compatible limit used only when Maximum number of records is omitted. Most users should leave this blank and use Maximum number of records above." }, "searchTerms": { "title": "🔎 Search terms, categories, or place IDs", "type": "array", "description": "Enter one or more precise Google Maps searches. Example: medspas in Scottsdale, Arizona; laser hair removal clinics in Scottsdale, Arizona. Distinct categories usually improve coverage. You can also enter a place ID such as place_id:ChIJ8_JBApXMDUcRDzXcYUPTGUY. Leave empty to use the preset niche and location.", "items": { "type": "string" }, "default": [] }, "googleMapsUrls": { "title": "🔗 Google Maps URLs", "type": "array", "description": "Paste Google Maps search, category, or exact business URLs. Example: a Maps search for roofers in Dallas. Exact place URLs are extracted directly. Leave empty when using the preset niche or custom search terms.", "items": { "type": "string" }, "default": [] }, "includeTemplateOutreach": { "title": "Generate tailored call scripts", "type": "boolean", "description": "Create a tailored cold-call script for every saved business. The Actor fills the business name, location, service, visible opportunity, and decision-maker first name when available. Leave disabled when you only need lead data.", "default": false }, "includeTemplateColdEmails": { "title": "Also generate cold-email templates", "type": "boolean", "description": "Also create a subject and email body when a website or decision-maker email was found. Enable company contact discovery or decision-maker enrichment to supply emails. Records without an email still receive a call script.", "default": false }, "outreachSenderName": { "title": "Sender / caller name", "type": "string", "description": "Name used in call introductions and email signatures. Example: Alex. Keep the default only when you plan to replace it after export.", "default": "Your Name" }, "outreachSenderBusinessName": { "title": "Your business or agency name", "type": "string", "description": "Your agency or company name. Example: Northstar Growth. Leave blank to omit a company name from the message.", "default": "" }, "outreachSenderWebsite": { "title": "Your website", "type": "string", "description": "Your public website, including https://. Example: https://northstargrowth.com. Leave blank to omit it from the signature.", "default": "" }, "outreachOffer": { "title": "Offer or value proposition", "type": "string", "description": "Short offer used in outreach. Example: A free 3-point Google Maps and website audit. Leave blank to use your selected Services to sell.", "default": "" }, "findBusinessEmail": { "title": "✉️ Find website business email address ($)", "type": "boolean", "description": "Find a publicly visible business email on the company website and relevant contact pages. This adds website requests and may increase runtime. Not every business publishes an email.", "default": false }, "verifyEmails": { "title": "✅ Verify discovered emails ($)", "type": "boolean", "description": "Verify the discovered website email and populate Email verification status. This may use a paid verification service. Enable it for cleaner outreach lists; leave it off for faster, lower-cost discovery.", "default": false }, "findFacebookProfile": { "title": "📘 Find Facebook profile link ($)", "type": "boolean", "description": "Find the company Facebook profile linked from its website. Share links and tracking URLs are ignored. Enable only if Facebook is useful to your workflow.", "default": false }, "findInstagramProfile": { "title": "📸 Find Instagram profile ($)", "type": "boolean", "description": "Find the company Instagram profile linked from its website. Posts, reels, and share links are ignored.", "default": false }, "findYouTubeChannel": { "title": "▶️ Find YouTube channel ($)", "type": "boolean", "description": "Find the company YouTube channel linked from its website. Individual videos, playlists, embeds, and share URLs are ignored.", "default": false }, "findTikTokProfile": { "title": "🎵 Find TikTok profile ($)", "type": "boolean", "description": "Find the company TikTok profile linked from its website. Video and share URLs are ignored.", "default": false }, "findTwitterProfile": { "title": "𝕏 Find X (Twitter) profile ($)", "type": "boolean", "description": "Find the company X/Twitter profile linked from its website. Post, intent, and share URLs are ignored.", "default": false }, "findLinkedInProfile": { "title": "💼 Find LinkedIn profile ($)", "type": "boolean", "description": "Find the LinkedIn company or public profile linked from the business website. Share URLs are ignored.", "default": false }, "onlyWithEmail": { "title": "📧 Only businesses with discovered emails", "type": "boolean", "description": "Save only businesses where a website or decision-maker email was found. Useful for email campaigns. This can substantially reduce the final record count; leave disabled when phone outreach is acceptable.", "default": false }, "includeWebsiteAudit": { "title": "🧭 Run website sales opportunity audit ($)", "type": "boolean", "description": "Create a lightweight, evidence-based website opportunity audit. Example: identify missing HTTPS, contact forms, booking links, title/meta basics, analytics, live chat, or social links. This adds website processing and is not a full Lighthouse or technical SEO audit.", "default": false }, "maximumLeadsEnrichmentRecords": { "title": "👤 Maximum decision makers per business ($)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum person-level contacts to request for each business with a valid website. Use 0 to disable this paid add-on, 1 for a cost-controlled best-contact search, or a higher number when you need several contacts at each company.", "default": 0 }, "leadsEnrichmentDepartments": { "title": "🏢 Decision-maker departments", "type": "array", "description": "Choose departments that are likely to buy your offer. Example: C-Suite and Marketing for SEO; Operations for automation; Sales for appointment setting. Leave empty to allow all departments. Used only when Maximum leads per place is above 0.", "items": { "type": "string", "enum": [ "c_suite", "product", "engineering_technical", "design", "education", "finance", "human_resources", "information_technology", "legal", "marketing", "medical_health", "operations", "sales", "consulting" ], "enumTitles": [ "C-Suite", "Product", "Engineering & Technical", "Design", "Education", "Finance", "Human Resources", "Information Technology", "Legal", "Marketing", "Medical & Health", "Operations", "Sales", "Consulting" ] }, "default": [] }, "verifyLeadsEnrichmentEmails": { "title": "✅ Verify decision-maker emails ($)", "type": "boolean", "description": "Verify each returned decision-maker email. Decisive provider results can be chargeable; catch-all, unknown, timeout, and technical-error results are treated as inconclusive. Leave disabled if you verify contacts elsewhere.", "default": false }, "includeReviews": { "title": "🌟 Collect review and reputation signals ($)", "type": "boolean", "description": "Collect individual review records for each saved business. Example: use this for review-generation prospects, reputation repair, complaint analysis, or recent customer feedback. Leave disabled when rating and total review count are enough.", "default": false }, "maxReviews": { "title": "⭐ Reviews to collect per business ($)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum reviews to collect per business. Use 3–5 for lightweight prospecting or 10–20 for deeper reputation analysis. Higher values require more requests and may increase runtime and cost. Use 0 to keep only rating and total review count.", "default": 4 }, "reviewsDateFilter": { "title": "📅 Only reviews posted after (optional)", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Collect only reviews after an exact date or within a recent period. Examples: 2026-01-01, 3 months, or 2 weeks. Leave blank to allow reviews from any date.", "default": "" }, "reviewsSort": { "title": "🔃 Sort reviews by", "enum": [ "most_relevant", "newest", "highest_rating", "lowest_rating" ], "type": "string", "description": "Choose which reviews to collect first. Newest is best for recent monitoring; Most relevant gives Google's representative selection; Lowest rating isolates complaints; Highest rating highlights positive feedback.", "default": "newest" }, "reviewsFilterKeywords": { "title": "🔎 Filter reviews by keywords", "type": "string", "description": "Only keep reviews or owner responses containing one of these comma-separated terms. Example: appointment, wait time, booking, phone. Leave blank to collect reviews without a keyword filter.", "default": "" }, "includeAiAnalysis": { "title": "🤖 Generate AI opportunity analysis ($)", "type": "boolean", "description": "Generate evidence-based opportunity analysis and outreach fields. Example: turn low reviews and no clear booking path into a prioritized reputation or booking opportunity. If AI is unavailable, deterministic scoring remains available so the run can still complete.", "default": false }, "includeOutreachCopy": { "title": "📝 Generate outreach email and call opener ($)", "type": "boolean", "description": "Generate an AI outreach angle, cold email subject and body, and call opener. This also enables AI analysis so the message stays grounded in collected evidence. Leave disabled when template outreach or raw lead data is sufficient.", "default": false }, "aiPitchTone": { "title": "🎙️ AI pitch tone", "enum": [ "friendly", "direct", "premium", "agency-style", "consultative", "short" ], "type": "string", "description": "Choose the writing style for AI outreach. Friendly works for most local businesses; Direct is concise; Premium suits high-value services; Consultative is advisory; Short is useful for compact campaigns.", "default": "friendly" }, "crmExportFormat": { "title": "CRM-ready CSV format", "enum": [ "generic", "mailchimp", "mailgun", "mailjet" ], "type": "string", "description": "Choose the column layout for the platform CSV and Google Sheets delivery. General CRM keeps all records; Mailchimp, Mailgun, and Mailjet exports require an email.", "default": "generic" }, "crmEmailSource": { "title": "Email source for CRM export", "enum": [ "website", "decision_maker", "combined" ], "type": "string", "description": "Choose website emails, decision-maker emails, or both. Combined email-platform exports create one row per unique address. The general CRM export also populates all_emails and the shared email verification status.", "default": "combined" }, "webhookUrl": { "title": "🔔 Webhook URL", "type": "string", "description": "Optional public HTTPS endpoint for completed records. The Actor sends batches of 100 with format details and the run summary. Works with n8n, Make, Zapier-style webhook steps, and custom CRM endpoints. Leave blank to disable.", "default": "" }, "googleSheetsUrl": { "title": "📊 Google Sheets Web App URL", "type": "string", "description": "Paste a deployed Google Apps Script Web App URL ending in /exec. The Actor appends the selected CRM rows. A normal docs.google.com spreadsheet edit URL cannot receive direct writes. Leave blank to disable.", "default": "" }, "googleSheetsSheetName": { "title": "Google Sheets tab name", "type": "string", "description": "Worksheet tab to create or append to. Example: Leads or Dallas Dentists. Used only when a Google Sheets Web App URL is provided.", "default": "Leads" } } }, "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 } } } } } } } } } }