{ "openapi": "3.0.1", "info": { "title": "Google Maps Leads Scraper - Emails, Phones, Socials & AI Pitch", "description": "Enterprise Google Maps B2B lead extractor with verified emails, executive contact names, direct phone numbers, WhatsApp links, social media handles (LinkedIn, Instagram, Facebook, TikTok), Google reviews with AI sentiment, opening hours, tech stack, and ready-to-send AI cold outreach pitches.", "version": "1.0", "x-build-id": "FOxnAO9WCzLgy12Ac" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev00~google-maps-leads-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev00-google-maps-leads-scraper-api", "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/dev00~google-maps-leads-scraper-api/runs": { "post": { "operationId": "runs-sync-dev00-google-maps-leads-scraper-api", "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/dev00~google-maps-leads-scraper-api/run-sync": { "post": { "operationId": "run-sync-dev00-google-maps-leads-scraper-api", "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": { "searchQueries": { "title": "Search Terms / Keywords", "type": "array", "description": "List of keywords or business queries to search on Google Maps (e.g., 'coffee shop London', 'dentists in Miami', 'plumbers Chicago')." }, "startUrls": { "title": "Direct Google Maps URLs (Optional)", "type": "array", "description": "Direct Google Maps place or search URLs to enrich directly (e.g. https://www.google.com/maps/place/...).", "items": { "type": "string" } }, "placeIds": { "title": "Place IDs / CIDs (Optional)", "type": "array", "description": "Direct Google Place IDs or CIDs to enrich.", "items": { "type": "string" } }, "location": { "title": "Location / City (Optional)", "type": "string", "description": "Optional location or country to append to queries (e.g., 'London, UK' or 'New York, NY')." }, "maxPlacesPerSearch": { "title": "Maximum places to scrape per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of places/leads to extract per search query (up to 1,000).", "default": 5 }, "deep_grid": { "title": "πŸ—ΊοΈ Deep Area Grid Search (Quadtree)", "type": "boolean", "description": "Subdivides the target area into multi-coordinate viewport grids to bypass Google's 120-place cap and maximize lead extraction.", "default": false }, "radius_km": { "title": "πŸ“ Radial Distance Geofence (km)", "type": "number", "description": "Optional strict radial circle filter around center coordinates in kilometers (e.g., 5)." }, "center_lat": { "title": "Center Latitude (for Radius)", "type": "number", "description": "Center latitude coordinate for radius filtering." }, "center_lng": { "title": "Center Longitude (for Radius)", "type": "number", "description": "Center longitude coordinate for radius filtering." }, "language": { "title": "Language (hl)", "enum": [ "en", "es", "fr", "de", "it", "pt", "ar", "nl", "ja" ], "type": "string", "description": "Google Maps interface language code.", "default": "en" }, "country": { "title": "Country / Region (gl)", "type": "string", "description": "Google Maps regional domain / country code.", "default": "us" }, "enrich_emails": { "title": "πŸ“§ Add-on: Company Contacts & Emails (+ $3.00 / 1k)", "type": "boolean", "description": "Extract verified business emails, executive contact names, and positions from the company's official domain.", "default": false }, "enrich_socials": { "title": "πŸ“± Add-on: Social Media Profile Enrichment (+ $100.00 / 1k)", "type": "boolean", "description": "Extract official company social media profiles: LinkedIn, Instagram, Facebook, TikTok, Twitter/X, and YouTube.", "default": false }, "enrich_place_details": { "title": "⚑ Add-on: Additional Place Details (+ $2.00 / 1k)", "type": "boolean", "description": "Extract opening hours, service options matrix, popular times, amenities, photos, price symbols, and plus codes.", "default": false }, "scrape_reviews": { "title": "⭐ Add-on: Scrape Google Reviews & AI Sentiment (+ $0.50 / 1k)", "type": "boolean", "description": "Extract latest customer reviews (author, rating, text, date, owner reply) and generate an AI Customer Sentiment summary.", "default": false }, "max_reviews_per_place": { "title": "Maximum Reviews per Place", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of recent reviews to extract per place when review scraping is enabled.", "default": 5 }, "enrich_business_leads": { "title": "πŸ’Ό Add-on: Business Leads & Corporate Phone (+ $100.00 / 1k)", "type": "boolean", "description": "Extract verified corporate phone numbers and estimated employee team size.", "default": false }, "enrich_technologies": { "title": "πŸ’» Add-on: CMS & Technology Stack (+ $2.00 / 1k)", "type": "boolean", "description": "Detect underlying CMS, frameworks, e-commerce systems, and analytics powering the company website.", "default": false }, "enrich_domain_rank": { "title": "πŸ“ˆ Add-on: SimilarWeb Traffic Rank (+ $1.00 / 1k)", "type": "boolean", "description": "Extract SimilarWeb global traffic rank for the company domain.", "default": false }, "ai_analysis": { "title": "πŸ€– Add-on: Single Competitor AI Analysis & Cold Pitch (+ $25.00 / 1k)", "type": "boolean", "description": "Generate an AI digital maturity score (0-100), digital growth opportunities, and a ready-to-send tailored B2B cold outreach email pitch.", "default": false }, "filter_only_unclaimed": { "title": "Filter: Only Unclaimed Listings (Agency Goldmine)", "type": "boolean", "description": "Filter results to only return businesses that have NOT claimed their Google Business Profile.", "default": false }, "filter_only_with_website": { "title": "Filter: Only places with website (+ $1.00 / 1k)", "type": "boolean", "description": "Filter results to only return businesses that have an active official website.", "default": false }, "filter_only_with_phone": { "title": "Filter: Only places with phone number", "type": "boolean", "description": "Filter results to only return businesses that have a listed phone number.", "default": false }, "filter_only_with_email": { "title": "Filter: Only places with extracted email", "type": "boolean", "description": "Filter results to only return businesses that have at least one verified email found.", "default": false }, "filter_min_rating": { "title": "Filter: Minimum Google Rating", "type": "number", "description": "Exclude businesses with Google rating below this threshold (e.g. 4.0 or 4.5)." }, "webhook_url": { "title": "Webhook URL (Zapier, Make, CRM)", "type": "string", "description": "Optional HTTP POST Webhook URL to deliver the extracted dataset upon run completion." } } }, "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 } } } } } } } } } }