Die bol API ist das technische Fundament, mit dem Verkäufer ihre Geschäftsprozesse auf bol.com automatisieren können. Ob du nun Bestellungen verwalten, Preise anpassen oder Werbekampagnen durchführen möchtest - die bol API ermöglicht es, alles programmatisch zu regeln, ohne manuell durch das Verkaufsportal zu klicken. In diesem Artikel erklären wir, wie die bol API funktioniert, welche Endpunkte verfügbar sind, wie du loslegst und wann du besser für eine fertige Integration entscheiden solltest.
Was ist die bol API und warum ist sie wichtig?
API steht für Application Programming Interface - eine technische Schnittstelle, über die Softwaresysteme miteinander kommunizieren. Die bol API ermöglicht es Verkäufern, ihre eigene Software oder Drittanbieter-Tools mit dem bol.com-Plattform zu verbinden. Das bedeutet, dass du Prozesse wie Bestellverwaltung, Lagerverwaltung, Preisänderungen und Versandbestätigungen vollständig automatisieren kannst.
Für Verkäufer mit mehr als 50 Produkten oder mehreren Verkaufskanälen ist die bol API fast unverzichtbar. Manuelle Arbeit über das Seller Dashboard (SDD) ist zeitaufwändig und fehleranfällig. Mit einer API-Verbindung sparst du nicht nur Stunden pro Woche, sondern minimierst auch Fehler, die zu schlechten Leistungsbewertungen führen können.
Von Plaza API zu Retailer API
Bol.com hat die alte Plaza API durch die modernere Retailer API ersetzt. Die Plaza API wird nicht mehr unterstützt und neue Verbindungen sind nur über die Retailer API möglich. Diese bietet bessere Leistungen, mehr Endpunkte, verbesserte Sicherheit und umfangreichere Dokumentation. Wenn du noch eine alte Plaza-Verbindung verwendest, ist es essentiell, so schnell wie möglich zu migrieren.
Die drei API's von bol.com erklärt
Bol.com bietet drei separate API's, die zusammen das gesamte Spektrum an Verkäuferfunktionen abdecken. Jede API hat ihr eigenes Ziel und eine eigene Menge an Endpunkten.
| API | Primäre Funktion | Wichtigste Endpunkte | Geeignet für |
|---|---|---|---|
| Retailer API | Vollständige Bestellverwaltung und Produktmanagement | Bestellungen, Sendungen, Retouren, Angebote, Lager, Provision | Alle Verkäufer |
| Offer API | Produktangebot und Preisverwaltung | Angebote (CRUD), Preisgestaltung, Lagerverwaltung, Produktinhalte | Verkäufer mit großen Katalogen |
| Advertiser API | Werbekampagnen und Berichterstellung | Kampagnen, Werbe-gruppen, Schlüsselwörter, Leistungsberichte | Verkäufer mit Werbebudget |
Bol Retailer API
Die Retailer API ist die umfangreichste und meistgenutzte API von bol.com. Mit ihr kannst du fast alle Verkaufsprozesse automatisieren: von der Abfrage neuer Bestellungen und der Bestätigung von Sendungen bis hin zur Verarbeitung von Retouren und der Abfrage von Provisionen. Die Retailer API unterstützt auch die Verwaltung deines Produktangebots, die Aktualisierung von Lagerbeständen und die Abfrage von Leistungsberichten.
Bol Offer API
Die Offer API konzentriert sich speziell auf die Verwaltung deines Produktangebots. Mit ihr kannst du neue Produkte hochladen, bestehende Angebote anpassen, Preise ändern und Lagerbestände aktualisieren. Für Verkäufer mit hunderten oder tausenden von Produkten ist diese API unverzichtbar, um Preise und Lagerbestände in Echtzeit mit deinem ERP- oder WMS-System zu synchronisieren.
Bol Advertiser API
Mit der Advertiser API automatisierst du deine Sponsored Products-Kampagnen. Du kannst Kampagnen erstellen, Werbe-gruppen verwalten, Gebote anpassen und umfangreiche Leistungsberichte abrufen - einschließlich Impressionen, Klicks, Konversionen und ACoS (Advertising Cost of Sale). Dies ist besonders wertvoll, wenn du mehrere Kampagnen gleichzeitig durchführst und schnell auf Basis von Daten optimieren möchtest.
Wichtigste Endpunkte und Funktionen
Die bol API bietet Dutzende Endpoints. Hier findest du eine Übersicht der am häufigsten verwendeten Endpoints pro Kategorie, damit du schnell einschätzen kannst, welche du benötigst.
| Kategorie | Endpoint | Methode | Beschreibung |
|---|---|---|---|
| Bestellungen | /orders | GET | Alle offenen Bestellungen abrufen |
| Bestellungen | /orders/{orderId} | GET | Details einer bestimmten Bestellung anzeigen |
| Versand | /orders/{orderId}/shipment | PUT | Versand bestätigen mit Track & Trace |
| Rücksendungen | /returns | GET | Offene Rücksendungen abrufen |
| Rücksendungen | /returns/{returnId} | PUT | Rücksendung bearbeiten (akzeptieren/ablehnen) |
| Angebote | /offers | POST | Neues Produktangebot erstellen |
| Angebote | /offers/{offerId} | PUT | Preis, Lagerbestand oder Zustand ändern |
| Lagerbestand | /offers/{offerId}/stock | PUT | Lagerbestand aktualisieren |
| Provision | /commission | GET | Provisionsprozentsätze pro Kategorie abrufen |
| Einblicke | /insights/performance | GET | Leistungscores und KPIs abrufen |
Authentifizierung und Sicherheit
Die bol API verwendet OAuth 2.0 für die Authentifizierung. Das bedeutet, dass du zuerst API-Zugangsdaten (Client ID und Client Secret) in deinem bol.com-Verkaufskonto erstellen musst. Mit diesen Zugangsdaten beantragst du ein temporäres Zugangstoken, das du bei jedem API-Aufruf mitübermittelst.
Schritt-für-Schritt-Authentifizierung einrichten
- Anmelden im Partnerportal - Gehe zu deinem Verkaufskonto auf bol.com Partner Login und navigiere zu Einstellungen > API-Einstellungen
- API-Zugangsdaten erstellen - Klicke auf "Neue API-Zugangsdaten erstellen" und bewahre deine Client ID und Client Secret sicher auf
- Zugangstoken anfordern - Sende eine POST-Anfrage an das Token-Endpoint mit deinen Zugangsdaten (Base64-codiert), um ein Bearer-Token zu erhalten
- Token verwenden - Füge das Token als Authorization-Header bei jedem API-Aufruf hinzu
- Token erneuern - Zugangstoken verfallen nach einer bestimmten Zeit; implementiere die automatische Token-Erneuerung in deiner Anwendung
Bewahre deine API-Zugangsdaten niemals in öffentlichen Code-Repositorys oder gemeinsam genutzten Dokumenten auf. Verwende Umgebungsvariablen oder einen Secret-Manager. Bei einem Verdacht auf einen Leck kannst du deine Zugangsdaten direkt über das Partnerportal zurückziehen.
Ratenlimits und Best Practices
Bol.com hat strenge Ratenlimits, um die API-Server zu schützen. Wenn du zu viele Anfragen in kurzer Zeit sendest, erhältst du einen HTTP 429-Fehler (Too Many Requests). Es ist wichtig, deine Anwendung so zu entwerfen, dass sie die Ratenlimits respektiert.
| Aspekt | Limit | Empfehlung |
|---|---|---|
| Anfragen pro Minute | Variabel pro Endpoint | Implementiere exponentielles Backoff bei 429-Fehlern |
| Bulk-Operationen | Max. 1.000 Elemente pro Batch | Teile große Updates in kleinere Batches auf |
| Token-Gültigkeit | Begrenzte Lebensdauer | Cache Tokens und erneuere sie proaktiv vor Ablauf |
| Tägliche Limit | Abhängig vom Kontotyp | Überwache deinen API-Verbrauch über das Partnerportal |
| Gleichzeitige Anfragen | Begrenzte Anzahl gleichzeitig | Verwende eine Anfrage-Warteschlange mit Drosselung |
Best Practices für API-Verwendung
- Webhooks verwenden - Anstatt kontinuierlich nach neuen Bestellungen zu fragen, richte Webhooks ein, damit bol.com deinen Server bei Änderungen benachrichtigt
- Retry-Logik implementieren - Bei temporären Fehlern (5xx-Statuscodes) versuche die Anfrage erneut mit exponentiellem Backoff
- Antworten cachen - Speichere häufig abgefragte Daten (wie Provisionssätze) lokal, um unnötige API-Anfragen zu vermeiden
- Alle API-Anfragen loggen - Führe ein detailliertes Logbuch, um Fehler zu debuggen und deinen API-Gebrauch zu überwachen
- Eingaben validieren - Überprüfe Daten, bevor du sie an die API sendest, um unnötige Fehlermeldungen zu vermeiden
Selbst bauen vs. fertige Integration
Eine der wichtigsten Entscheidungen für Verkäufer ist, ob sie selbst Software auf der bol-API aufbauen oder ein bestehendes Tool verwenden. Beide Optionen haben Vor- und Nachteile, die stark von deiner technischen Kenntnis, deinem Budget und deiner Größe abhängen.
| Kriterium | Selbst bauen | Fertiges Tool |
|---|---|---|
| Anfangskosten | €5.000–€15.000+ (Entwicklungszeit) | €0–€50/Monat |
| Dauer | 2–6 Monate | Sofort verfügbar |
| Wartung | Ständig erforderlich (API-Updates) | Im Preis des Anbieters enthalten |
| Flexibilität | Vollständig maßgeschneidert möglich | Beschränkt auf angebotene Funktionen |
| Risiko | Hoch (Entwickler-Abhängigkeit) | Niedrig (bewährte Plattform) |
| Skalierbarkeit | Abhängig von der Architektur | In der Regel gut skalierbar |
| Support | Eigene Verantwortung | Helpdesk und Dokumentation verfügbar |
| API-Updates | Selbst implementieren | Automatisch aktualisiert |
Wann das Selbstbauen sinnvoll ist
Das Selbstbauen ist nur sinnvoll, wenn du einen sehr spezifischen Workflow hast, der von keinem bestehenden Tool unterstützt wird, du über ein dediziertes Entwicklerteam verfügst, das die Verbindung langfristig warten kann, und du bereit bist, die laufenden Kosten für Wartung und API-Updates zu tragen. In der Praxis trifft dies auf weniger als 5% der Verkäufer zu.
Warum die meisten Verkäufer sich für ein Tool entscheiden
Für den größten Teil der Verkäufer ist ein fertiges Tool die vernünftigste Wahl. Tools wie Boloo bieten umfassende Integrationen mit der bol-API, ohne dass du selbst programmieren musst. Du erhältst Zugang zu Funktionen wie einem Product-Tracker, Keyword-Verkenner, Sales-Dashboard und automatischer Rechnungsstellung - alles auf der offiziellen bol-API aufgebaut.
Häufige Fehler beim Arbeiten mit der bol-API
Viele Verkäufer und Entwickler machen dieselben Fehler, wenn sie zum ersten Mal mit der bol-API arbeiten. Durch das Kennen dieser Fehler kannst du wertvolle Zeit und Geld sparen.
- Keine Fehlerbehandlung implementieren - Die API kann vorübergehend nicht verfügbar sein oder unerwartete Antworten zurückgeben. Ohne gute Fehlerbehandlung kann dein ganzes System blockieren
- Rate-Limits ignorieren - Zu viele Anfragen in kurzer Zeit führen zu einer Blockierung. Implementiere immer eine Drosselung und exponentiellen Backoff
- Zugangsdaten hartcoden - API-Schlüssel in den Quellcode zu platzieren, ist ein ernstes Sicherheitsrisiko. Verwende immer Umgebungsvariablen
- Nicht im Sandbox-Modus testen - Bol.com bietet eine Testumgebung an. Verwende diese, um deine Integration zu testen, bevor du live gehst
- Veraltete Dokumentation befolgen - Die API wird regelmäßig aktualisiert. Konsultiere immer die offizielle Dokumentation auf dem bol.com-Entwicklerportal
- Keine Überwachung einrichten - Ohne Überwachung bemerkst du Probleme erst, wenn Kunden sich beschweren. Richte Alarme für Fehler und Verzögerungen ein
Wie Boloo die bol-API optimal nutzt
Boloo ist vollständig auf der offiziellen bol-API aufgebaut und bietet Verkäufern eine benutzerfreundliche Oberfläche über der technischen Komplexität. Wo du mit der rohen API selbst Endpunkte aufrufen und Daten verarbeiten musst, erledigt Boloo dies automatisch im Hintergrund.
- Product Tracker - Überwacht Konkurrenten und Preisänderungen über die Retailer-API
- Product-Datenbank - Durchsuche das gesamte bol.com-Sortiment mit erweiterten Filtern
- Keyword-Verkenner - Analysiere Suchvolumina und Trends über API-Daten
- Ranking-Checker - Verfolge deine Position in den Suchergebnissen automatisch
- Listing-Generator AI - Optimiere deine Produktseiten auf Basis von API-Erkenntnissen
- Sales-Dashboard - Echtzeit-Umsatz- und Bestelldaten über die Retailer-API
- Gewinnrechner - Berechnet Margen einschließlich aktueller Provisionssätze
- Automatische Facturierung - Generiert Rechnungen automatisch bei neuen Bestellungen
- E-Mail-Kampagnen - Versende gezielte Kampagnen auf Basis von Kundendaten
- LVB-Box-Größen-Prüfer - Optimiere Versandkosten mit den richtigen Kartongrößen
Der Vorteil eines Tools wie Boloo ist, dass du von allen Möglichkeiten der bol-API profitierst, ohne selbst technische Kenntnisse benötigen zu müssen. Aktualisierungen der API werden automatisch verarbeitet und du kannst direkt mit der Optimierung deines Verkaufs beginnen.
Häufig gestellte Fragen zur bol-API
Wo finde ich die offizielle bol-API-Dokumentation?
Die offizielle Dokumentation ist auf dem bol.com-Entwicklerportal verfügbar. Hier findest du detaillierte Beschreibungen aller Endpunkte, Beispielcode, eine Sandbox-Umgebung zum Testen und Changelogs mit den neuesten Updates. Die Dokumentation wird regelmäßig bei neuen Releases aktualisiert.
Was ist der Unterschied zwischen der Retailer-API und der alten Plaza-API?
Die Plaza-API ist vollständig ausgemustert und wird nicht mehr unterstützt. Die Retailer-API ist der Nachfolger mit besseren Leistungen, mehr Endpunkten, verbesserter OAuth 2.0-Authentifizierung und erweiterter Funktionalität. Alle neuen Verbindungen müssen über die Retailer-API aufgebaut werden. Bestehende Plaza-Verbindungen funktionieren nicht mehr.
Brauche ich Programmierkenntnisse, um die bol-API zu verwenden?
Um direkt mit der API zu arbeiten, benötigst du Programmierkenntnisse in einer Sprache wie Python, PHP, JavaScript oder C#. Hast du keine technische Vorkenntnisse? Dann solltest du besser ein fertiges Tool wie Boloo wählen, das die API-Integration für dich übernimmt, ohne dass du selbst Code schreiben musst.
Gibt es Kosten für die Nutzung der bol API?
Die Nutzung der bol API selbst ist kostenlos. Du zahlst keine extra Kosten für API-Anfragen. Die Kosten liegen im Entwickeln und Warten deiner eigenen Software oder im Abonnement eines Tools, das die API für dich nutzt. Bol.com berechnet nur die reguläre Verkaufsprovision.
Wie oft wird die bol API aktualisiert?
Bol.com aktualisiert die API regelmäßig mit neuen Endpunkten, verbesserter Funktionalität und Sicherheitspatches. Große Updates werden im Voraus über das Developer Portal mit einer Migrationsfrist angekündigt. Es ist wichtig, diese Changelogs zu verfolgen, wenn du eine eigene Verbindung unterhältst - bei einem fertigen Tool wird dies automatisch abgehandelt.
Kann ich die bol API für mehrere Verkaufskonten nutzen?
Ja, du kannst die API für mehrere Verkaufskonten nutzen. Jedes Konto hat eigene API-Zugangsdaten. Tools wie Boloo unterstützen die Verwaltung mehrerer Konten aus einem Dashboard, was die Übersicht für Verkäufer mit mehreren Marken oder Geschäften erheblich vereinfacht.
Starte kostenlos mit Boloo
Verwende die Tools von Boloo, um intelligenter auf Bol.com zu verkaufen. Probiere es kostenlos aus.
Boloo kostenlos testen
