{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Qualifier | Website Gaps + Outreach", "description": "Turn Google Maps results or existing business lists into qualified sales opportunities. Audit public websites, detect booking and lead-generation gaps, rank leads by confidence, recommend services, and generate evidence-backed outreach.", "version": "2.4", "x-build-id": "4zjgFpr8Cdx6jgKVe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lirafrt~local-business-funnel-gap-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lirafrt-local-business-funnel-gap-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/lirafrt~local-business-funnel-gap-finder/runs": { "post": { "operationId": "runs-sync-lirafrt-local-business-funnel-gap-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/lirafrt~local-business-funnel-gap-finder/run-sync": { "post": { "operationId": "run-sync-lirafrt-local-business-funnel-gap-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": { "inputMode": { "title": "Input mode", "enum": [ "maps_search", "dataset", "businesses", "domains" ], "type": "string", "description": "Google Maps search is the fastest way to start. You can also import an Apify dataset, business objects, or website domains.", "default": "maps_search" }, "searchQueries": { "title": "Google Maps search queries", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Used in Google Maps mode. Use a niche plus a US city and state, for example auto repair shops in Tampa FL.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "maxResultsPerQuery": { "title": "Leads per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of Google Maps businesses requested for each search.", "default": 50 }, "targetService": { "title": "Service you sell", "enum": [ "auto", "online_booking", "website_redesign", "lead_capture", "tracking", "crm_automation" ], "type": "string", "description": "Automatic prioritizes booking and lead-capture offers while requiring matching website evidence before recommending a service.", "default": "auto" }, "includeNearMisses": { "title": "Include high-quality near misses", "type": "boolean", "description": "Publishes contactable businesses that pass every quality gate but score from the near-miss floor through 39 to a separate dataset. These rows do not trigger the qualified-opportunity event.", "default": true }, "outputLanguage": { "title": "Outreach language", "enum": [ "en", "pt-BR", "es" ], "type": "string", "description": "Controls evidence, service recommendations, gap summaries, and channel-specific outreach.", "default": "en" }, "mapsProviderActorId": { "title": "Maps provider Actor ID", "minLength": 1, "type": "string", "description": "Current verified default: compass/crawler-google-places.", "default": "compass/crawler-google-places" }, "maxTotalResults": { "title": "Maximum total results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap applied to every input mode.", "default": 500 }, "maxDiscoveryCostUsd": { "title": "Maximum Maps discovery charge in USD", "pattern": "^[0-9]+(\\.[0-9]{1,4})?$", "type": "string", "description": "Passed as a Decimal to the child Actor. The current default provider requires at least USD 0.50 per run.", "default": "2.00" }, "discoveryTimeoutSeconds": { "title": "Maps discovery timeout in seconds", "minimum": 60, "maximum": 3600, "type": "integer", "description": "Maximum child Actor runtime before the Maps call is stopped.", "default": 900 }, "discoveryMemoryMbytes": { "title": "Child Actor memory in MB", "minimum": 128, "maximum": 4096, "type": "integer", "description": "Memory allocated to the Maps child Actor.", "default": 512 }, "apifyDatasetId": { "title": "Apify dataset", "type": "string", "description": "Required only in dataset mode." }, "businesses": { "title": "Business objects", "maxItems": 5000, "type": "array", "description": "Required only in businesses mode. Recognized fields are documented below and additional source fields are accepted as upstream metadata.", "items": { "type": "object", "additionalProperties": true, "properties": { "title": { "title": "Business title", "type": "string", "description": "Primary business name, commonly returned by Google Maps datasets.", "nullable": true }, "name": { "title": "Business name", "type": "string", "description": "Alternative field containing the business name.", "nullable": true }, "businessName": { "title": "Business name alias", "type": "string", "description": "Normalized or custom business-name field.", "nullable": true }, "website": { "title": "Website", "type": "string", "description": "Public business website URL or domain.", "nullable": true }, "websiteUrl": { "title": "Website URL alias", "type": "string", "description": "Alternative field containing the public business website URL.", "nullable": true }, "phone": { "title": "Phone", "type": "string", "description": "Public business phone number.", "nullable": true }, "category": { "title": "Category", "type": "string", "description": "Business category or industry label.", "nullable": true }, "address": { "title": "Address", "type": "string", "description": "Public business address.", "nullable": true }, "rating": { "title": "Rating", "type": "number", "description": "Business rating from 0 to 5.", "nullable": true, "minimum": 0, "maximum": 5 }, "totalScore": { "title": "Total score alias", "type": "number", "description": "Alternative rating field from 0 to 5.", "nullable": true, "minimum": 0, "maximum": 5 }, "reviewsCount": { "title": "Reviews count", "type": "integer", "description": "Number of public reviews.", "nullable": true, "minimum": 0 }, "reviewCount": { "title": "Review count alias", "type": "integer", "description": "Alternative field containing the number of public reviews.", "nullable": true, "minimum": 0 } } }, "default": [] }, "domains": { "title": "Domains or website URLs", "maxItems": 5000, "uniqueItems": true, "type": "array", "description": "Required only in domains mode. Only public HTTP and HTTPS targets are audited.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "websiteField": { "title": "Website field alias", "minLength": 1, "type": "string", "description": "Custom website field used by dataset and businesses modes.", "default": "website" }, "nameField": { "title": "Business name field alias", "minLength": 1, "type": "string", "description": "Custom business name field used by dataset and businesses modes.", "default": "title" }, "phoneField": { "title": "Phone field alias", "minLength": 1, "type": "string", "description": "Custom phone field used by dataset and businesses modes.", "default": "phone" }, "categoryField": { "title": "Category field alias", "minLength": 1, "type": "string", "description": "Custom category field used by dataset and businesses modes.", "default": "category" }, "auditWebsite": { "title": "Audit websites", "type": "boolean", "description": "When false, records are marked skipped and no website request is made.", "default": true }, "detectBooking": { "title": "Detect online booking", "type": "boolean", "description": "When disabled, booking output is null and booking never affects score, service, pitch, gaps, or confidence. Website records cannot qualify while this required evidence check is disabled.", "default": true }, "detectContactForm": { "title": "Detect contact forms and pages", "type": "boolean", "description": "When disabled, contact outputs are null and never affect commercial output. Website records cannot qualify while these required evidence checks are disabled.", "default": true }, "detectChatOrWhatsApp": { "title": "Detect chat and WhatsApp", "type": "boolean", "description": "When disabled, chat and WhatsApp outputs are null and never affect commercial output. Website records cannot qualify while these required evidence checks are disabled.", "default": true }, "generatePitchAngle": { "title": "Generate outreach for research results", "type": "boolean", "description": "Legacy compatibility option. Sales-ready leads and near misses always include complete channel-specific outreach. This flag only affects optional outreach for non-candidates when generateOutreachForAllResults is also enabled.", "default": true }, "generateOutreachForAllResults": { "title": "Generate outreach for all scored results", "type": "boolean", "description": "Legacy research option. When false, outreach is generated only for records that meet the configured publication contract.", "default": false }, "maxPagesPerWebsite": { "title": "Maximum secondary pages per website", "minimum": 1, "maximum": 20, "type": "integer", "description": "Only same-host contact or booking pages are fetched.", "default": 5 }, "maxConcurrency": { "title": "Maximum concurrent website audits", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of website audits allowed to run concurrently.", "default": 5 }, "batchSize": { "title": "Streaming batch size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum records retained per batch. Processing occurs in concurrency-sized waves so spending-limit termination does not start the entire batch at once.", "default": 25 }, "minimumOpportunityScore": { "title": "Qualified opportunity score", "minimum": 40, "maximum": 40, "type": "integer", "description": "Fixed at 40 so changing an input cannot bypass qualified-opportunity charging or reclassify sales-ready rows as research output without that event.", "default": 40 }, "nearMissMinimumOpportunityScore": { "title": "Near-miss opportunity floor", "minimum": 25, "maximum": 39, "type": "integer", "description": "Contactable records scoring from this value through 39, and still below the configured qualification threshold, are published to the separate near_misses dataset.", "default": 25 }, "minimumConfidenceScore": { "title": "Minimum evidence confidence", "minimum": 0.9, "maximum": 1, "type": "number", "description": "Hard technical evidence-confidence floor. Values below 0.90 from legacy API inputs are safely raised to 0.90.", "default": 0.9 }, "minimumInformationCompletenessScore": { "title": "Minimum profile completeness", "minimum": 0.85, "maximum": 1, "type": "number", "description": "Hard floor for known, valid and applicable business-profile information. The website-audit group retains a separate hard floor of 0.87, and qualified commercial output must be complete.", "default": 0.85 }, "outputMode": { "title": "Audit evidence output", "enum": [ "qualified_only", "all_audits" ], "type": "string", "description": "Sales-ready leads always go to the default dataset and near misses to their own dataset. Choose all_audits only when you also want every outcome in the separate audit_results dataset.", "default": "qualified_only" }, "onlyReturnOpportunities": { "title": "Return only qualified opportunities", "type": "boolean", "description": "Legacy compatibility option. When outputMode is omitted, true selects qualified_only and false selects all_audits. Conflicting explicit values are rejected. New inputs should use outputMode." } } }, "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 } } } } } } } } } }