Direkt abrufen
Die API ist kostenlos und ohne Anmeldung nutzbar.
Du entwickelst eine App, eine Karte oder ein Dashboard? Mit unserer REST-API bindest du Ladepunkte, Preise und Verfügbarkeiten in dein Projekt ein. Hier findest du alle Funktionen, Codebeispiele und einen Bereich, in dem du Anfragen direkt testen kannst.
Die API ist kostenlos und ohne Anmeldung nutzbar.
Wähle ein Beispiel und rufe die Ladepunkte für deinen gewünschten Ort ab.
Suche im Umkreis, frage einzelne Ladepunkte ab oder lies nach, woher die Daten stammen.
Rufe die Daten direkt per GET ab. Die Daten-Endpunkte liefern JSON.
https://v49457.1blu.de/api/v1Bei HTTP 429 gibt der Header Retry-After die Wartezeit in Sekunden an. Wenn du regelmäßig dieselben Daten abfragst, speichere die Antwort kurz zwischen.
Diese Beispiele suchen bis zu zehn Standorte in Hamm mit mindestens einem als frei gemeldeten Ladepunkt. Die Antwort enthält auch die weiteren Ladepunkte am jeweiligen Standort.
curl --get 'https://v49457.1blu.de/api/v1/stations' \
--data-urlencode 'city=Hamm' \
--data-urlencode 'only_available=true' \
--data-urlencode 'limit=10'import json
from urllib.parse import urlencode
from urllib.request import urlopen
params = urlencode({
"city": "Hamm",
"only_available": "true",
"limit": 10,
})
url = f"https://v49457.1blu.de/api/v1/stations?{params}"
with urlopen(url, timeout=15) as response:
data = json.load(response)
for station in data["items"]:
print(station["name"], station["address"]["city"])
for point in station["charging_points"]:
price = point["pricing"]["adhoc_price_gross_eur_per_kwh"]
print(point["evse_id"], point["status"], price)async function ladeStationen() {
const params = new URLSearchParams({
city: "Hamm",
only_available: "true",
limit: "10",
});
const response = await fetch(
`https://v49457.1blu.de/api/v1/stations?${params}`
);
if (!response.ok) {
throw new Error(`API-Anfrage fehlgeschlagen: ${response.status}`);
}
const data = await response.json();
for (const station of data.items) {
console.log(station.name, station.charging_points);
}
}
ladeStationen().catch(console.error);{
"count": 1,
"has_more": false,
"limit": 10,
"offset": 0,
"items": [
{
"id": 123,
"name": "Beispiel-Ladestandort",
"charging_points": [
{
"evse_id": "DE*ABC*E12345*1",
"status": "available",
"status_updated_at": null,
"technical": {
"max_power_kw": 50,
"connectors": []
},
"pricing": {
"adhoc_price_gross_eur_per_kwh": 0.49,
"price_includes_vat": true,
"tariff_updated_at": null
}
}
]
}
]
}Die Beispiele fragen Daten erst ab, wenn du sie selbst ausführst.
Wähle eine Funktion und fülle die gewünschten Parameter aus. Erst mit „Anfrage senden“ wird die API aufgerufen. Die Tests verwenden denselben Datenbestand und dieselben Limits wie deine Anwendung.
Der Tester führt ausschließlich lesende GET-Abfragen aus.
Noch keine Anfrage gesendet.
Öffne eine Funktion für Parameter, Rückgabewerte und ein passendes Beispiel. Die folgenden JSON-Endpunkte beziehen sich auf die Basis-URL oben. Den Kartendienst findest du im Anschluss.
/stationsDie Antwort enthält items mit Standorten und ihren Ladepunkten. count zählt die zurückgegebenen Standorte; has_more zeigt an, ob weitere verfügbar sind; limit und offset geben den abgefragten Ausschnitt an.
| Parameter | Bedeutung |
|---|---|
city / postal_code | Teil eines Ortsnamens oder genaue Postleitzahl. |
lat / lon / radius_km | Mittelpunkt in WGS84 und Radius: 0,1–200 km, Standard 10 km. Ergebnisse werden nach Entfernung sortiert. |
min_lat / max_lat / min_lon / max_lon | Alle vier Werte gemeinsam begrenzen den Kartenausschnitt. Mit zusätzlichem Mittelpunkt wird nach Entfernung sortiert; der Radius entfällt. |
only_adhoc | true: nur Standorte mit gemeldeter Ad-hoc-Möglichkeit. Standard false. |
only_available | true: mindestens ein Ladepunkt ist als frei gemeldet. Standard false. |
min_power_kw | Ein passender Ladepunkt erreicht die angegebene Leistung in kW. |
max_price_kwh | Ein passender Ladepunkt hat einen bekannten Kilowattstundenpreis bis zu diesem Betrag in EUR. Beachte die Hinweise zur Umsatzsteuer unten. |
limit / offset | 1–500 Standorte pro Abfrage, Standard 50. offset beginnt bei 0. |
curl --get 'https://v49457.1blu.de/api/v1/stations' \
--data-urlencode 'lat=51.69685' \
--data-urlencode 'lon=7.76306' \
--data-urlencode 'radius_km=10' \
--data-urlencode 'min_power_kw=50' \
--data-urlencode 'max_price_kwh=0.59' /stations/{station_id}Liefert einen Standort mit Betreiber, Adresse, Koordinaten und allen zugeordneten Ladepunkten.
| Parameter | Bedeutung |
|---|---|
station_id | Interne numerische ID aus einer Stationsantwort. Ersetze 123 im Beispiel durch eine vorhandene ID. Unbekannte IDs liefern 404. |
curl 'https://v49457.1blu.de/api/v1/stations/123'/evse/{evse_id}Liefert technische Daten, Preisangaben, Status und den zugehörigen Standort.
| Parameter | Bedeutung |
|---|---|
evse_id | Vollständige EVSE-ID aus einer Stationsantwort. Im URL-Pfad URL-kodieren. Die ID im Beispiel ist ein Platzhalter; unbekannte IDs liefern 404. |
curl 'https://v49457.1blu.de/api/v1/evse/DE%2AABC%2AE12345%2A1'/geocodeLiefert eine Liste mit Ortsname, Postleitzahl, Koordinaten und Anzahl hinterlegter Standorte. Die Suche umfasst Orte und PLZ-Gebiete; eine vollständige Straßenadresssuche ist nicht enthalten.
| Parameter | Bedeutung |
|---|---|
q | Stadt, Gemeinde oder Postleitzahl; mindestens 2 Zeichen. |
limit | 1–20 Ergebnisse, Standard 6. |
curl --get 'https://v49457.1blu.de/api/v1/geocode' \
--data-urlencode 'q=Hamm' \
--data-urlencode 'limit=6'/statsZählt gespeicherte Standorte, Ad-hoc-Standorte, Ladepunkte, Ladepunkte mit Preis, als frei gemeldete Ladepunkte und aktive Feeds. Die Antwort wird bis zu 30 Sekunden zwischengespeichert und beschreibt den erfassten Datenbestand.
Für diese Abfrage brauchst du keine Parameter.
curl 'https://v49457.1blu.de/api/v1/stats'/sourcesLiefert aktive Quellen mit Anbieter, Feedtitel, Angebotslink und Lizenz. Beachte bei einer Weiterverwendung die Bedingungen der jeweiligen Quelle.
Für diese Abfrage brauchst du keine Parameter.
curl 'https://v49457.1blu.de/api/v1/sources'Zusätzlich zu den JSON-Endpunkten gibt es einen Kartendienst unter derselben Domain. Sein Pfad beginnt direkt mit /tiles/, ohne /api/v1.
© OpenStreetMap-Mitwirkende. Die Karte kombiniert einen Deutschland-Ausschnitt von BBBike mit Übersichtskacheln von VersaTiles. Die verwendete Kartendatenbank steht unter der Open Database License 1.0. Sie enthält die geografischen Daten der Hintergrundkarte.
Kartendaten herunterladen (MBTiles, ca. 4,1 GB)/tiles/{z}/{x}/{y}.pngErsetzt z durch die Zoomstufe (0–19) und x und y durch die nicht negativen ganzzahligen Kachelkoordinaten. GET liefert ein PNG-Bild; HEAD fragt nur die HTTP-Header ab.
Die Antwort verwendet Cache-Control: public, max-age=2592000, immutable (30 Tage). Ungültige Koordinaten liefern 400; fehlende oder nicht erreichbare Kacheln können weitere Fehlerantworten auslösen. Bei der Kartennutzung ist die Namensnennung der OpenStreetMap-Mitwirkenden erforderlich.
curl 'https://v49457.1blu.de/tiles/6/33/21.png' \
--output karte.pngDer interaktive Tester oben zeigt JSON-Antworten. Für die PNG-Kacheln kannst du dieses cURL-Beispiel oder deine Kartenbibliothek verwenden.
Die Tabellen erklären die Felder der Antworten. Nicht jeder Betreiber liefert alle Angaben; fehlende Informationen können als null oder leere Listen vorliegen.
| Feld | Inhalt |
|---|---|
count / limit / offset / has_more | Anzahl der zurückgegebenen Standorte, Seitengröße, Startposition und Hinweis auf weitere Treffer. |
data_guarantee / attribution | Hinweise zur Herkunft und Verwendung der Daten in der Suchantwort. |
items | Liste der gefundenen Standorte. Die Einzelabfrage liefert den Standort direkt. |
id / external_station_id / name | Interne ID, externe Standortkennung und Name. |
operator.id / operator.name | Betreiberkennung und Betreibername. |
address | street, house_number, postal_code, city und country. |
coordinates | latitude und longitude in WGS84. |
adhoc_charging_available | Gemeldete Ad-hoc-Möglichkeit am Standort. |
payment_methods / authentication_methods | Vom Betreiber angegebene Bezahl- und Authentifizierungsmethoden. |
summary | total_charging_points und available_charging_points am Standort. |
charging_points | Alle Ladepunkte des Standorts, auch solche, die nicht zu den gesetzten Filtern passen. |
static_data_updated_at | Zeitangabe zur Aktualisierung der Standortdaten. |
distance_meters | Entfernung zum Suchmittelpunkt, falls lat und lon angegeben wurden. |
| Feld | Inhalt |
|---|---|
evse_id / adhoc_available | EVSE-Kennung und gemeldete Ad-hoc-Möglichkeit am Ladepunkt. |
status | available, occupied, reserved, out_of_service oder unknown. |
status_updated_at | Zeitpunkt der letzten Statusübernahme in unsere Datenbank; kann fehlen. Er ist nicht zwingend der Zeitpunkt einer Zustandsänderung vor Ort. |
status_source | Optional: provider_name, last_checked_at, last_http_status, last_check_ok und mode (delta oder conditional_feed). Der Quellenabruf ist von der letzten Statusübernahme je Ladepunkt zu unterscheiden. |
technical.max_power_kw / technical.current_type | Maximale Ladeleistung in kW und gemeldete Stromart. |
technical.connectors | Anschlussangaben aus der Quelle, z. B. connector_type, connector_format, max_power_kw, voltage_v, max_current_a und charging_mode. |
station | Nur bei GET /evse/{evse_id}: id, external_station_id, name, operator_name, street, postal_code, city, latitude und longitude. |
| Feld | Inhalt |
|---|---|
currency | Gemeldete Währung; bei fehlender Angabe EUR. |
adhoc_price_gross_eur_per_kwh / adhoc_price_eur_per_kwh | Kilowattstundenpreis nach der Umsatzsteuerbehandlung der API. Beide Felder enthalten in der Regel denselben Betrag. |
raw_feed_price_eur_per_kwh / price_includes_vat | Ursprünglicher Kilowattstundenpreis und Umsatzsteuerkennzeichnung der Quelle (true, false oder null). |
adhoc_price_gross_eur_per_min / adhoc_price_eur_per_min | Minutenpreis nach der Umsatzsteuerbehandlung der API. |
adhoc_session_fee_eur | Startgebühr je Ladevorgang. |
adhoc_blocking_fee_eur_per_min / adhoc_blocking_grace_period_min | Blockiergebühr je Minute und die dazu gemeldete Karenzzeit. |
max_charging_duration_min | Gemeldete maximale Ladedauer in Minuten. |
tariff_name / tariff_rules | Tarifname und zusätzliche Tarifregeln aus der Quelle. |
tariff_updated_at | Zeitangabe zur Tarifaktualisierung; kann fehlen. |
| Feld | Inhalt |
|---|---|
GET /geocode | Liste mit display_name, short_name, postal_code, lat, lon und station_count. |
GET /stats | status, updated_at, stations_total, stations_adhoc, charging_points_total, charging_points_with_price, charging_points_available und active_feeds. |
GET /sources | platform, cc_by_4_0_license_url, cc0_1_0_license_url, active_sources_count und sources. |
sources[] | provider_name, feed_title, offer_id, offer_url und license je Datenquelle. |
POST /tokens/register | status, token, token_prefix, name, rate_limit_per_minute, message und docs_url. Den Token sicher aufbewahren. |
Für Werkzeuge und eigene Clients: OpenAPI-Spezifikation als JSON. Sie enthält die aktuellen Pfade, Parametertypen, Pflichtfelder und Grenzen.
Hier findest du die wichtigsten Datenfelder und Hinweise, die dir beim Einbinden helfen.
Der Standort enthält Betreiber, Adresse, Koordinaten sowie Bezahl- und Authentifizierungsmethoden. Unter charging_points findest du die einzelnen Ladepunkte.
evse_idtechnicalstatusavailable bedeutet als frei gemeldet. Andere oder unbekannte Zustände sind keine bestätigte Freimeldung.Unter pricing stehen bekannte kWh- und Minutenpreise, Start- und Blockiergebühren, Karenzzeit, maximale Ladedauer sowie Tarifname und Regeln.
status_updated_attariff_updated_atstatic_data_updated_atoffset und limit kannst du weitere Treffer abrufen. Solange has_more gleich true ist, gibt es weitere Standorte. count zählt nur die aktuelle Seite.null oder leere Listen stehen für fehlende Angaben. Ein fehlender Preis bedeutet nicht, dass das Laden kostenlos ist.price_includes_vat und raw_feed_price_eur_per_kwh.