# 🇩🇪 German Solar & Energy Leads — Marktstammdatenregister (`inexhaustible_glass/german-energy-register`) Actor

Scrape Germany's official Marktstammdatenregister (MaStR): 6.2M+ Photovoltaik / Solaranlagen + Wind, Biomass & storage. Betreiber (operator), location, capacity (kW), commissioning date & status. Solar/battery/PV leads. Free, no key, no proxy.

- **URL**: https://apify.com/inexhaustible\_glass/german-energy-register.md
- **Developed by:** [Hitman studio](https://apify.com/inexhaustible_glass) (community)
- **Categories:** Lead generation, Business, Real estate
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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

## 🇩🇪⚡ German Solar & Energy Leads — Marktstammdatenregister (MaStR) Scraper

Scrape Germany's **official Marktstammdatenregister (MaStR)** — the Bundesnetzagentur's
public register of **every power installation in Germany**: **6.2 million+ solar PV
systems (Photovoltaik / Solaranlagen)** plus wind, biomass, hydro and storage.

Get the **Betreiber (operator), location, capacity (kW), commissioning date and status**
for each installation — the exact lead data the German energy industry buys.

**Free. Official open data (DL-DE-BY-2.0). No API key, no proxy, never blocked.**

> Keywords: Marktstammdatenregister, MaStR, Photovoltaik, PV-Anlagen, Solaranlage,
> Solaranlagen Daten, Betreiber, Balkonkraftwerk, Batteriespeicher / Stromspeicher,
> Windkraft, EEG-Anlagen, Bundesnetzagentur, German solar leads, PV operator data,
> solar installation database Germany, energy data export.

### 🎯 Who buys this (Germany = Europe's #1 solar & battery market)
| Buyer | Use |
|---|---|
| 🔋 **Battery-storage (Batteriespeicher) sellers** | Find solar homes with **no battery yet** → retrofit leads |
| ☀️ **Solar installers (PV-Installateure)** | Competitor installs + area-by-area new projects |
| 🔧 **O&M / maintenance (Wartung)** | Ageing systems needing service contracts |
| 🔌 **Heat-pump / EV-charger sellers** | Solar households = ideal upsell customers |
| 💰 **Investors, insurers, manufacturers** | Market intelligence & asset data |

### ⚙️ Filters (input)
| Field | Description |
|---|---|
| **Energy type** | ☀️ Solar PV (default, 6.2M+), 💨 Wind, 🌿 Biomass, 💧 Hydro |
| **Bundesland** | Any of the 16 federal states, or all Germany |
| **Postcode (PLZ)** | e.g. `80` = Munich, `10` = Berlin, `20` = Hamburg |
| **Min / Max capacity (kW)** | e.g. max 30 = home rooftops (battery leads); min 100 = commercial |
| **Commissioned after** | fresh leads from a date, e.g. `2024-01-01` |
| **Companies only** | named, contactable B2B operators (private persons are anonymised) |
| **Operational only** | only systems currently *In Betrieb* |

### 📤 Output (per installation, clean — no nulls)
- `mastr_number`, `unit_name`, `energy_type`, `status`
- **`operator_name`**, `operator_mastr_number`, `operator_type` (company vs private)
- `city`, `postcode`
- `capacity_kw_gross`, `capacity_kw_net`, `solar_modules`
- `commissioned_date`, `registered_date`, `last_updated`
- `profile_url` (the official MaStR page)
- `lead_score`, `lead_grade` (UTILITY / COMMERCIAL / LARGE-ROOF / HOME+ / SMALL-HOME),
  `lead_tags` (`named_operator`, `battery_retrofit_candidate`, `operational`)

#### Lead angle
Private rooftop solar without a battery → tagged **`battery_retrofit_candidate`**.
Commercial/named operators → tagged **`named_operator`** (directly contactable B2B lead).
Bigger capacity = higher `lead_score`.

### 🔌 Source
The official MaStR register's internal JSON API
(`marktstammdatenregister.de`). Public data under the open **DL-DE-BY-2.0** licence —
free to use and republish with attribution to the Bundesnetzagentur. No key, no proxy.

### Note on operator names (GDPR)
Operators that are **private individuals are anonymised** by the register (shown as
"natürliche Person") — that's the law. **Companies, farms and organisations appear with
their real name** — turn on **Companies only** to keep just those contactable B2B leads.

# Actor input Schema

## `energyType` (type: `string`):

Which kind of installation to scrape. Solar PV is the biggest (6.2M+ units).
## `bundesland` (type: `string`):

Limit to one German state. Leave empty for all of Germany.
## `postcode` (type: `string`):

Target a postcode area — e.g. '80' for Munich, '10' for Berlin, '20' for Hamburg. Leave empty for the whole state/country.
## `minCapacityKw` (type: `integer`):

Only installations with at least this much capacity. E.g. 100 for commercial/large-roof systems, 1000 for utility-scale.
## `maxCapacityKw` (type: `integer`):

Only installations up to this capacity. E.g. 30 to target home rooftop systems (battery-retrofit leads).
## `commissionedAfter` (type: `string`):

Only installations switched on from this date — great for fresh leads. Example: 2024-01-01.
## `companiesOnly` (type: `boolean`):

Keep only installations whose operator is a company/organisation (named, contactable B2B lead). Private individuals are anonymised in the register, so turn this ON for sales leads.
## `operationalOnly` (type: `boolean`):

Only currently-operating installations (skip planned/decommissioned).
## `maxResults` (type: `integer`):

Cap how many installations to return.

## Actor input object example

```json
{
  "energyType": "solar",
  "bundesland": "bayern",
  "postcode": "80",
  "maxCapacityKw": 30,
  "commissionedAfter": "2024-01-01",
  "companiesOnly": false,
  "operationalOnly": true,
  "maxResults": 1000
}
````

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "bundesland": "bayern",
    "postcode": "80",
    "maxCapacityKw": 30,
    "commissionedAfter": "2024-01-01"
};

// Run the Actor and wait for it to finish
const run = await client.actor("inexhaustible_glass/german-energy-register").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "bundesland": "bayern",
    "postcode": "80",
    "maxCapacityKw": 30,
    "commissionedAfter": "2024-01-01",
}

# Run the Actor and wait for it to finish
run = client.actor("inexhaustible_glass/german-energy-register").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 '{
  "bundesland": "bayern",
  "postcode": "80",
  "maxCapacityKw": 30,
  "commissionedAfter": "2024-01-01"
}' |
apify call inexhaustible_glass/german-energy-register --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=inexhaustible_glass/german-energy-register",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇩🇪 German Solar & Energy Leads — Marktstammdatenregister",
        "description": "Scrape Germany's official Marktstammdatenregister (MaStR): 6.2M+ Photovoltaik / Solaranlagen + Wind, Biomass & storage. Betreiber (operator), location, capacity (kW), commissioning date & status. Solar/battery/PV leads. Free, no key, no proxy.",
        "version": "1.0",
        "x-build-id": "YK9EqebjcIVodpXQJ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/inexhaustible_glass~german-energy-register/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-inexhaustible_glass-german-energy-register",
                "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/inexhaustible_glass~german-energy-register/runs": {
            "post": {
                "operationId": "runs-sync-inexhaustible_glass-german-energy-register",
                "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/inexhaustible_glass~german-energy-register/run-sync": {
            "post": {
                "operationId": "run-sync-inexhaustible_glass-german-energy-register",
                "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": {
                    "energyType": {
                        "title": "⚡ Energy type",
                        "enum": [
                            "solar",
                            "wind",
                            "biomass",
                            "hydro"
                        ],
                        "type": "string",
                        "description": "Which kind of installation to scrape. Solar PV is the biggest (6.2M+ units).",
                        "default": "solar"
                    },
                    "bundesland": {
                        "title": "📍 Federal state (Bundesland)",
                        "enum": [
                            "",
                            "baden-wuerttemberg",
                            "bayern",
                            "berlin",
                            "brandenburg",
                            "bremen",
                            "hamburg",
                            "hessen",
                            "mecklenburg-vorpommern",
                            "niedersachsen",
                            "nordrhein-westfalen",
                            "rheinland-pfalz",
                            "saarland",
                            "sachsen",
                            "sachsen-anhalt",
                            "schleswig-holstein",
                            "thueringen"
                        ],
                        "type": "string",
                        "description": "Limit to one German state. Leave empty for all of Germany.",
                        "default": ""
                    },
                    "postcode": {
                        "title": "📮 Postcode (PLZ) starts with",
                        "type": "string",
                        "description": "Target a postcode area — e.g. '80' for Munich, '10' for Berlin, '20' for Hamburg. Leave empty for the whole state/country."
                    },
                    "minCapacityKw": {
                        "title": "🔼 Minimum capacity (kW)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only installations with at least this much capacity. E.g. 100 for commercial/large-roof systems, 1000 for utility-scale."
                    },
                    "maxCapacityKw": {
                        "title": "🔽 Maximum capacity (kW)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only installations up to this capacity. E.g. 30 to target home rooftop systems (battery-retrofit leads)."
                    },
                    "commissionedAfter": {
                        "title": "📅 Commissioned after (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Only installations switched on from this date — great for fresh leads. Example: 2024-01-01."
                    },
                    "companiesOnly": {
                        "title": "🏢 Companies/organisations only (named operators)",
                        "type": "boolean",
                        "description": "Keep only installations whose operator is a company/organisation (named, contactable B2B lead). Private individuals are anonymised in the register, so turn this ON for sales leads.",
                        "default": false
                    },
                    "operationalOnly": {
                        "title": "✅ Operational only (In Betrieb)",
                        "type": "boolean",
                        "description": "Only currently-operating installations (skip planned/decommissioned).",
                        "default": true
                    },
                    "maxResults": {
                        "title": "🔢 Max results",
                        "minimum": 1,
                        "maximum": 500000,
                        "type": "integer",
                        "description": "Cap how many installations to return.",
                        "default": 1000
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```