{ "openapi": "3.0.1", "info": { "title": "Home Services Google Maps Lead Generator", "description": "Scrapes HVAC, plumbing, electrical, roofing, solar, garage door, pest control, and landscaping contractor leads from Google Maps by location, with email/services/social enrichment from each contractor's website. Drives the real Clura Chrome extension headlessly.", "version": "0.1", "x-build-id": "BSmq3U7zhOfhAd9XE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clura~home-services-google-maps-lead-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clura-home-services-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/clura~home-services-google-maps-lead-generator/runs": { "post": { "operationId": "runs-sync-clura-home-services-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/clura~home-services-google-maps-lead-generator/run-sync": { "post": { "operationId": "run-sync-clura-home-services-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": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "Zip codes or city/state to search, e.g. [\"75201\", \"Austin, TX\"]. Every search term below is run once per location.", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "searchTerms": { "title": "Search terms (trade/business types)", "type": "array", "description": "Home services business types to search for, rotated across each location to surface more leads (Google Maps' ranking varies by query wording). Defaults to a rotation across all 8 trades if left empty: HVAC Company, AC Repair Service, Heating Contractor, Air Conditioning Contractor, Furnace Repair Service, Duct Cleaning Service, Commercial HVAC Contractor, Refrigeration Service, Indoor Air Quality Company, Plumber, Plumbing Company, Electrician, Electrical Contractor, Roofing Contractor, Roof Repair Service, Solar Panel Installer, Garage Door Repair Service, Pest Control Service, Termite Control Company, Landscaping Company, Lawn Care Service. Add your own for a custom trade or search.", "default": [ "Plumber" ], "items": { "type": "string" } }, "maxLeadsPerSearch": { "title": "Max leads per search", "type": "integer", "description": "Maximum leads to collect per location x search term combination.", "default": 5 }, "maxPagesPerSearch": { "title": "Max pages/scrolls per search", "type": "integer", "description": "Maximum pagination steps (scrolls) per search before stopping.", "default": 2 }, "enrichWebsite": { "title": "Enrich from website", "type": "boolean", "description": "Visit each lead's website homepage to extract email, detected services across all 8 trades, 24/7 emergency availability, and social media links.", "default": true }, "crawlContactPages": { "title": "Crawl Contact/About page if no email found", "type": "boolean", "description": "If the homepage has no email, follow one Contact/About-style link on the site to look there too. Costs one extra page visit per lead that needs it. Default false.", "default": false }, "openaiApiKey": { "title": "OpenAI API key", "type": "string", "description": "Used only if Google Maps' markup has changed enough that the built-in recipe stops working, to re-map fields via AI. Falls back to the OPENAI_API_KEY env var if omitted." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings to route the browser's traffic through.", "default": { "useApifyProxy": false } }, "recipeOverride": { "title": "Advanced: recipe override", "type": "object", "description": "Advanced use only. Overrides the actor's built-in Google Maps selectors." } } }, "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 } } } } } } } } } }