{ "openapi": "3.0.1", "info": { "title": "Google Maps Business Lead & Email Finder", "description": "Find business leads on Google Maps by category, keyword, or location and collect name, address, phone, website, rating, review count, and coordinates. Optionally adds emails and social links found on each business's own website.", "version": "1.0", "x-build-id": "wdMPBcMnl2mFScdCG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~google-maps-business-lead-and-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-google-maps-business-lead-and-email-finder", "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/dataspryva~google-maps-business-lead-and-email-finder/runs": { "post": { "operationId": "runs-sync-dataspryva-google-maps-business-lead-and-email-finder", "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/dataspryva~google-maps-business-lead-and-email-finder/run-sync": { "post": { "operationId": "run-sync-dataspryva-google-maps-business-lead-and-email-finder", "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": { "mode": { "title": "What do you want to do?", "enum": [ "searchPlaces", "specificPlaces", "enrichWebsites" ], "type": "string", "description": "Search Google Maps, look up specific places, or enrich a list of websites you already have.", "default": "searchPlaces" }, "searchQueries": { "title": "Search phrases", "type": "array", "description": "Natural-language searches such as 'coffee shops in Austin TX'. Include the place in each phrase, or use the location field below.", "items": { "type": "string" } }, "locationQuery": { "title": "Location (optional)", "type": "string", "description": "Adds a shared location to every search phrase, for example 'Austin, TX, USA'. Leave empty when your phrases already name the place." }, "category": { "title": "Category", "type": "string", "description": "Business category such as bakery, dentist or plumber. Used when keyword and search phrases are empty.", "default": "bakery" }, "keyword": { "title": "Keyword (overrides category)", "type": "string", "description": "Custom search term such as 'boutique coffee' or 'pet grooming'. Takes priority over category." }, "state": { "title": "US state", "enum": [ "All", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "type": "string", "description": "US state for the search. Choose 'All' for nationwide. Ignored for non-US countries.", "default": "All" }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "IN", "BR", "MX", "JP", "KR", "CN", "AE", "SG" ], "type": "string", "description": "Country for the search. Other countries can be named directly in a search phrase.", "default": "US" }, "websites": { "title": "Business websites", "type": "array", "description": "Websites to read for contact details, one per line. Bare domains such as example.com are accepted.", "items": { "type": "string" } }, "placeUrls": { "title": "Google Maps place URLs", "type": "array", "description": "Google Maps place links copied from the address bar or a previous export.", "items": { "type": "string" } }, "placeIds": { "title": "Google Place IDs", "type": "array", "description": "Canonical Google Place IDs starting with 'ChIJ'.", "items": { "type": "string" } }, "max_results": { "title": "Maximum leads", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of leads to save. Google returns a ranked window of roughly 150-220 businesses per search phrase, so a larger request may end when that window ends.", "default": 100 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Keep only businesses rated at least this value (1.0-5.0). Leave empty for any rating." }, "extractEmails": { "title": "Find emails and social profiles", "type": "boolean", "description": "Visit each business website for public emails, phone numbers and social profiles. Turn off for a faster Maps-only run.", "default": true }, "maxEmailsPerWebsite": { "title": "Emails per website", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum email addresses to keep for one business website.", "default": 5 }, "maxContactPagesPerWebsite": { "title": "Pages checked per website", "minimum": 1, "maximum": 10, "type": "integer", "description": "Homepage plus contact, about, legal, privacy or careers pages to read. More pages find more contacts but take longer.", "default": 3 }, "onlySaveResults": { "title": "Which places to save", "enum": [ "allPlaces", "onlyWithEmails", "onlyWithContacts" ], "type": "string", "description": "Save every business, only businesses with an email, or only businesses with any contact detail.", "default": "allPlaces" }, "categoryFilter": { "title": "Category filter words", "type": "array", "description": "Keep places whose Google Maps category contains all words of at least one entry. Leave empty for no category filter.", "items": { "type": "string" } }, "websiteFilter": { "title": "Website filter", "enum": [ "allPlaces", "withWebsite", "withoutWebsite" ], "type": "string", "description": "Keep all places, only places with a website, or only places without one.", "default": "allPlaces" }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Check Google's public status and leave out permanently or temporarily closed places.", "default": false }, "language": { "title": "Language", "enum": [ "en", "af", "az", "id", "ms", "bs", "ca", "cs", "da", "de", "et", "es", "es-419", "eu", "fil", "fr", "gl", "hr", "zu", "is", "it", "sw", "lv", "lt", "hu", "nl", "no", "uz", "pl", "pt-BR", "pt-PT", "ro", "sq", "sk", "sl", "fi", "sv", "vi", "tr", "el", "bg", "ky", "kk", "mk", "mn", "ru", "sr", "uk", "ka", "hy", "iw", "ur", "ar", "fa", "am", "ne", "hi", "mr", "bn", "pa", "gu", "ta", "te", "kn", "ml", "si", "th", "lo", "my", "km", "ko", "ja", "zh-CN", "zh-TW", "zh", "pt" ], "type": "string", "description": "Language of the Google Maps interface and listing text.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }