{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Finder API With SEO Audit", "description": "Google Maps lead generation API for agencies, freelancers, and cold outreach teams. Find local businesses, score SEO opportunities, extract public contact data, and prioritize leads for website design, Local SEO, and GBP optimization.", "version": "0.3", "x-build-id": "SPUgdWkrDH2Y7NGjb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahabuddin38~Google-Maps-Lead-Finder-API-with-SEO-Audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahabuddin38-Google-Maps-Lead-Finder-API-with-SEO-Audit", "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/shahabuddin38~Google-Maps-Lead-Finder-API-with-SEO-Audit/runs": { "post": { "operationId": "runs-sync-shahabuddin38-Google-Maps-Lead-Finder-API-with-SEO-Audit", "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/shahabuddin38~Google-Maps-Lead-Finder-API-with-SEO-Audit/run-sync": { "post": { "operationId": "run-sync-shahabuddin38-Google-Maps-Lead-Finder-API-with-SEO-Audit", "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" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Local business searches to run, such as ac repair dubai, plumbers in chicago, dentists in london, or restaurants in lahore.", "items": { "type": "string" } }, "location": { "title": "Country or location", "type": "string", "description": "Optional location context appended to each query. Use a city, region, country, or full market such as Chicago, IL, United States." }, "country": { "title": "Country", "type": "string", "description": "Optional country fallback. If location is empty, this value is used as the location context." }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of Google Maps business leads to return for each search query.", "default": 10 }, "includeEmails": { "title": "Find emails", "type": "boolean", "description": "Visit business websites and contact pages to extract public email addresses where available.", "default": false }, "includePhones": { "title": "Include phones", "type": "boolean", "description": "Return phone numbers visible on Google Maps where available.", "default": true }, "includeWebsiteAudit": { "title": "Run website audit", "type": "boolean", "description": "Run a lightweight homepage audit for SSL, title tag, meta description, H1, schema, Open Graph, mobile hint, and page weight hint.", "default": true }, "includeSocials": { "title": "Find social links", "type": "boolean", "description": "Extract visible social profile links from business websites where available.", "default": false }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Only keep businesses with at least this many Google reviews." }, "maxReviews": { "title": "Maximum reviews", "minimum": 0, "type": "integer", "description": "Only keep businesses with no more than this many Google reviews. Useful for finding low-review SEO opportunities." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep businesses with at least this Google rating." }, "onlyWithoutWebsite": { "title": "Only businesses without websites", "type": "boolean", "description": "Return only businesses where no website was found on Google Maps.", "default": false }, "onlyClaimableOpportunities": { "title": "Only strong opportunities", "type": "boolean", "description": "Return only leads with clear prospecting angles, such as no website, weak website SEO, low reviews, or an unclaimed/claimable profile signal.", "default": false }, "exportReady": { "title": "CSV-friendly export fields", "type": "boolean", "description": "Add flattened fields such as exportEmail, exportPhone, exportSocials, and exportReason for spreadsheet and CRM workflows.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Browser page concurrency. Keep low for Google Maps reliability.", "default": 2 }, "requestTimeoutSecs": { "title": "Request timeout seconds", "minimum": 10, "maximum": 120, "type": "integer", "description": "Timeout used for Google Maps pages and website audit requests.", "default": 30 }, "debugLog": { "title": "Debug logging", "type": "boolean", "description": "Enable extra logs for troubleshooting selectors, search pages, and website audit failures.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Residential or Google-friendly proxies can improve reliability for larger runs." } } }, "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 } } } } } } } } } }