# Solar Installer Directory Scraper - EnergySage Suppliers (`jungle_synthesizer/solar-installer-directory-scraper`) Actor Scrape EnergySage's US solar installer directory — installers, financiers, and equipment partners. Extracts company names, addresses, phone, email, founding date, services, panel/inverter/battery brands, financing partners, licenses, and EnergySage Approved status. - **URL**: https://apify.com/jungle\_synthesizer/solar-installer-directory-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Lead generation, Business, Other - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## EnergySage Solar Installer Directory Scraper Scrape the US solar installer directory from [EnergySage](https://www.energysage.com). Returns company names, addresses, phone, email, founding date, services offered, panel and inverter brands installed, financing partners, license numbers, and EnergySage Approved status for ~6,800 installers, financiers, and equipment partners — every supplier the marketplace lists. --- ### Solar Installer Directory Scraper Features - Walks all 14 paginated supplier sitemaps, so the catalog is exhaustive - Returns 23 fields per supplier including JSON-LD core data and structured HTML sections - Captures the EnergySage Approved badge — the marketplace's quality flag - Pulls panel, inverter, and battery brand partnerships from each profile - Records associated financing companies, useful for fintech lead-gen pipelines - Filters by US state, service type, and approved-only - Sorts by sitemap lastmod so freshly-updated profiles surface first - Pure SSR scrape — no browser, no proxy, no captchas --- ### Who Uses Solar Installer Data? - **Solar manufacturers** — Map channel partner coverage by state and brand. Know which installers carry your panels, your competitor's panels, or both. - **Battery & inverter OEMs** — Identify installers running Tesla Powerwall, Enphase, FranklinWH, or LG so you can target outreach. - **Financing partners** — Find installers already integrated with GoodLeap, Sunlight, or Mosaic — and the ones that aren't. - **Lead-gen marketplaces** — Build screening lists for installer-quality programs based on EnergySage Approved status, license counts, and service breadth. - **M&A and rollup firms** — Aggregate installer footprints by service area and founding year to spot acquisition targets. --- ### How Solar Installer Directory Scraper Works 1. Pull the EnergySage sitemap index, find every `sitemap-suppliers.xml` page (14 of them). 2. Walk each sitemap, collect `/supplier/{id}/{slug}/` URLs paired with their lastmod date. 3. Sort by lastmod descending — recently-updated profiles first. 4. Fetch each profile, parse the JSON-LD `LocalBusiness` block, and read the structured HTML sections (Services Offered, Associated product manufacturers, Associated financing companies, Workmanship Warranty, Licenses, Insurance, States Served). 5. Apply your state, service, and approved-only filters before saving. --- ### Input ```json { "states": ["CA", "TX"], "service_filter": "Installation", "approved_only": false, "maxItems": 50 } ```` | Field | Type | Default | Description | |------------------|---------|---------|-------------| | `states` | array | `[]` | Two-letter state code filter (e.g. `["CA", "NY"]`). Empty = all states. | | `service_filter` | string | `""` | Match suppliers whose `servicesOffered` contains this string (case-insensitive). Common values: `Installation`, `Financing`, `Roofing`, `Electrical Contracting`, `Solar Repair & Maintenance`, `Commercial Solar`, `Energy Auditing`. | | `approved_only` | boolean | `false` | If true, return only suppliers with the EnergySage Approved badge. | | `maxItems` | integer | `15` | Maximum supplier profiles to scrape. Default is conservative for the platform's 5-minute test window — set higher for full crawls. | *** ### Solar Installer Directory Scraper Output Fields ```json { "companyName": "Sunergy", "supplierId": "26085", "profileUrl": "https://www.energysage.com/supplier/26085/sunergy/", "websiteUrl": "http://www.sunergycorp.com", "logoUrl": "https://es-media-prod.s3.amazonaws.com/media/supplier/logo/source/Sunergy_New_Logo.jpg", "phone": "", "email": "info@sunergycorp.com", "streetAddress": "20311 Hermana Cir", "city": "Lake Forest", "state": "CA", "zip": "92630", "yearEstablished": 2015, "description": "Founded in 2015, Sunergy was named EnergySage's 2026 California Installer of the Year and is the #1 Rated Enphase Platinum Installer.", "energysageApproved": false, "servicesOffered": ["Financing", "Energy Auditing", "Electrical Contracting", "General Contracting", "Solar Repair & Maintenance"], "productManufacturers": ["Enphase Energy", "IronRidge", "Solaria"], "financingPartners": ["Sungage Financial"], "statesServed": ["California"], "languagesSpoken": ["Chinese", "English", "Spanish"], "licenses": "California 1061794", "workmanshipWarranty": "Comprehensive, industry-leading warranties: 25-years on Solar Panels, 25-years on Inverters, 25-years on Workmanship", "insurance": "General Liability, Workers Compensation, Commercial Auto", "lastmod": "2026-04-27" } ``` | Field | Type | Description | |-------------------------|---------|-------------| | `companyName` | string | Supplier company name. | | `supplierId` | string | EnergySage supplier ID (numeric, from URL). | | `profileUrl` | string | Full URL to the supplier's EnergySage profile. | | `websiteUrl` | string | External company website (when listed). | | `logoUrl` | string | Supplier logo image URL. | | `phone` | string | Contact phone number. | | `email` | string | Contact email address. | | `streetAddress` | string | Headquarters street address. | | `city` | string | Headquarters city. | | `state` | string | Headquarters two-letter state code. | | `zip` | string | Headquarters ZIP/postal code. | | `yearEstablished` | integer | Founding year (null when EnergySage doesn't have it). | | `description` | string | Long-form profile description / About text. | | `energysageApproved` | boolean | True if the supplier holds the EnergySage Approved badge. | | `servicesOffered` | array | List of services offered (e.g. Installation, Financing, Roofing). | | `productManufacturers` | array | Brands the supplier installs (panels, inverters, batteries). | | `financingPartners` | array | Associated financing companies. | | `statesServed` | array | Full state names the supplier serves. | | `languagesSpoken` | array | Languages the supplier speaks. | | `licenses` | string | License numbers (free-text block). | | `workmanshipWarranty` | string | Workmanship warranty description. | | `insurance` | string | Insurance coverage description. | | `lastmod` | string | Sitemap lastmod ISO date for the profile. | *** ### FAQ #### How do I scrape EnergySage solar installers? The EnergySage Solar Installer Directory Scraper handles it. Run with no input to pull the most-recently-updated 15 suppliers, or set `maxItems` higher to crawl the full ~6,800-profile catalog. Filter by state, service type, or EnergySage Approved status. #### How much does the EnergySage Solar Installer Directory Scraper cost? The actor is priced on a per-event PPE model: $0.10 to start a run plus $0.001 per supplier record. A 1,000-record crawl runs about $1.10. Pricing is set on the actor's Apify page and changes propagate with the standard 14-day notice. #### What data does the EnergySage Solar Installer Directory Scraper return? 23 fields per supplier — company name, contact info, headquarters address, founding year, EnergySage Approved status, services offered, manufacturers carried (panels / inverters / batteries), financing partners, languages spoken, license numbers, workmanship warranty, insurance, and the supplier's URL on EnergySage. #### Can I filter by state or service type? Yes. Pass two-letter state codes via `states` (e.g. `["CA", "TX"]`) and a substring via `service_filter` (e.g. `"Financing"` or `"Commercial Solar"`). Set `approved_only: true` to limit to EnergySage-screened installers. #### Does the EnergySage Solar Installer Directory Scraper need proxies? No. EnergySage serves supplier profiles as plain server-rendered HTML with no captchas or bot defense, so the actor runs without proxies and without a browser. *** ### Need More Features? Have a specific filter, a missing field, or a related directory you want covered? File an [issue on the actor page](https://apify.com/jungle_synthesizer/solar-installer-directory-scraper/issues) and we'll take a look. ### Why Use the EnergySage Solar Installer Directory Scraper? - **Exhaustive coverage** — Walks every supplier sitemap. ~6,800 profiles, not just the first page of a search. - **Brand-level intel** — Captures panel, inverter, battery, and financing brand partnerships per supplier — useful for channel programs and competitive analysis. - **EnergySage Approved flag** — The marketplace's own quality screen, surfaced as a clean boolean field. - **No proxy, no browser** — Plain HTTP fetches. Cheap to run, no anti-bot babysitting. - **Sitemap-fresh** — Sorted by lastmod, so the most recently updated suppliers come first. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `states` (type: `array`): Filter by US state code (e.g. 'CA', 'NY', 'TX'). Leave empty to scrape all states. Filter is applied to the addressRegion field on each profile. ## `service_filter` (type: `string`): Filter to suppliers offering a specific service. Leave empty for all. Common values: 'Installation', 'Financing', 'Roofing', 'Electrical Contracting', 'Solar Repair & Maintenance', 'Commercial Solar', 'Energy Auditing'. ## `approved_only` (type: `boolean`): If true, only return suppliers with the 'EnergySage Approved' badge — installers that passed the marketplace's screening for experience, licensing, and reviews. ## `maxItems` (type: `integer`): Maximum number of supplier profiles to scrape. Increase for larger crawls. Default keeps test runs under the 5-minute platform tester window. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [], "service_filter": "", "approved_only": false, "maxItems": 15 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [], "service_filter": "", "approved_only": false, "maxItems": 15 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/solar-installer-directory-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [], "service_filter": "", "approved_only": False, "maxItems": 15, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/solar-installer-directory-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [], "service_filter": "", "approved_only": false, "maxItems": 15 }' | apify call jungle_synthesizer/solar-installer-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/solar-installer-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Solar Installer Directory Scraper - EnergySage Suppliers", "description": "Scrape EnergySage's US solar installer directory — installers, financiers, and equipment partners. Extracts company names, addresses, phone, email, founding date, services, panel/inverter/battery brands, financing partners, licenses, and EnergySage Approved status.", "version": "1.0", "x-build-id": "hmiVFs5ujMohNdiGC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~solar-installer-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-solar-installer-directory-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/jungle_synthesizer~solar-installer-directory-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-solar-installer-directory-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/jungle_synthesizer~solar-installer-directory-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-solar-installer-directory-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", "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "states": { "title": "State Filter", "type": "array", "description": "Filter by US state code (e.g. 'CA', 'NY', 'TX'). Leave empty to scrape all states. Filter is applied to the addressRegion field on each profile.", "default": [] }, "service_filter": { "title": "Service Type Filter", "type": "string", "description": "Filter to suppliers offering a specific service. Leave empty for all. Common values: 'Installation', 'Financing', 'Roofing', 'Electrical Contracting', 'Solar Repair & Maintenance', 'Commercial Solar', 'Energy Auditing'.", "default": "" }, "approved_only": { "title": "EnergySage Approved Only", "type": "boolean", "description": "If true, only return suppliers with the 'EnergySage Approved' badge — installers that passed the marketplace's screening for experience, licensing, and reviews.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of supplier profiles to scrape. Increase for larger crawls. Default keeps test runs under the 5-minute platform tester window.", "default": 15 } } }, "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 } } } } } } } } } } ```