{ "openapi": "3.0.1", "info": { "title": "Solar Installer Lead Scraper - Verified Emails", "description": "Scrape solar installer and solar energy company leads from Google Maps with verified emails, phones and social links. Export clean data to HubSpot, Salesforce, CSV, JSON, or Excel.", "version": "1.0", "x-build-id": "FzJulP3lpHZq6mRJI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/samstorm~solar-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-samstorm-solar-lead-scraper", "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/samstorm~solar-lead-scraper/runs": { "post": { "operationId": "runs-sync-samstorm-solar-lead-scraper", "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/samstorm~solar-lead-scraper/run-sync": { "post": { "operationId": "run-sync-samstorm-solar-lead-scraper", "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": [ "businessType", "location" ], "properties": { "businessType": { "title": "Business Type", "enum": [ "Solar Energy Company", "Solar Panel Installation Service", "Solar Energy Contractor", "EV Charging Station Contractor", "Energy Auditor", "Custom" ], "type": "string", "description": "Select the type of solar business to target. The actor builds the Google Maps query automatically - e.g., 'Solar Energy Company' searches for 'Solar Energy Companys in [location]'. Choose 'Custom' to write your own query for niche searches.", "default": "Solar Energy Company" }, "location": { "title": "Location", "type": "string", "description": "The city, state, or region to search. Use 'City, ST' format for best results (e.g., 'Austin, TX' or 'Denver, CO'). You can also enter ZIP codes, neighborhoods, metro areas, or any geographic phrase Google Maps recognizes. Each location search returns up to ~120 listings." }, "searchQuery": { "title": "Custom Search Query", "type": "string", "description": "A raw Google Maps search query - only used when Business Type is 'Custom'. Write it exactly as you would type it into Google Maps. Example: 'commercial solar installers in San Diego, CA'. Ignored when a named Business Type is selected." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 500, "type": "integer", "description": "The maximum number of leads to collect and return. The prefill is set to 3 for a quick test run - increase to 50-200 for production use. Google Maps typically returns up to 120 results per search query; use a smaller number first to verify data quality before scaling up.", "default": 50 }, "enrichEmails": { "title": "Find Email Addresses", "type": "boolean", "description": "When enabled, the actor visits each business's website and scans contact pages, footers, and about pages for email addresses. This is what transforms raw Google Maps listings into a usable solar email list. Disable only if you need phone numbers and addresses without website crawling.", "default": true }, "verifyEmails": { "title": "Verify Email Deliverability", "type": "boolean", "description": "When enabled, each extracted email is validated via DNS MX lookup and SMTP handshake - confirming the mailbox exists before it reaches your list. Recommended for cold outreach where bounce rates hurt sender reputation. Adds ~1 min to the run. Only applies when 'Find Email Addresses' is enabled.", "default": true }, "enrichSocials": { "title": "Find Social Media Links", "type": "boolean", "description": "When enabled, the actor extracts social media profiles (Facebook, Instagram, LinkedIn, Twitter/X) from each business's website. Useful for LinkedIn outreach, Facebook ads targeting, or multi-channel ABM campaigns.", "default": true }, "outputFormat": { "title": "Output Format", "enum": [ "full", "hubspot", "salesforce" ], "type": "string", "description": "Controls the structure of the output dataset. 'Full' returns all available fields. 'HubSpot Import' reformats the data to match HubSpot's CSV import column names for direct upload. 'Salesforce Import' reformats for Salesforce data import. All formats are available in Apify's dataset export (CSV, JSON, Excel).", "default": "full" }, "proxyUrl": { "title": "Custom Proxy URL (optional)", "type": "string", "description": "Optional HTTP proxy URL for using third-party residential proxies instead of Apify's built-in proxies. Format: http://username:password@host:port. Leave empty to use Apify's default residential proxies." } } }, "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 } } } } } } } } } }