Was ist die Shopify API?
Die Shopify API ist eine programmatische Schnittstelle, ueber die externe Anwendungen mit einem Shopify-Shop kommunizieren. Sie ermoeglicht den Zugriff auf Produkte, Bestellungen, Kundendaten, Lagerbestaende und dutzende weitere Ressourcen, ohne dass jemand manuell im Shopify-Backend arbeiten muss.
In der Praxis bedeutet das: Dein ERP-System synchronisiert Bestellungen automatisch. Dein PIM-System aktualisiert Produktdaten in Echtzeit. Oder ein KI-Mitarbeiter berät deine Kunden auf Basis aktueller Produktverfuegbarkeit. All das laeuft ueber die API.
Shopify stellt nicht eine einzelne API bereit, sondern ein ganzes Oekosystem aus spezialisierten Schnittstellen. Die vier wichtigsten: die Admin REST API (Legacy, seit Oktober 2024 nicht mehr weiterentwickelt), die Admin GraphQL API (der neue Standard), die Storefront API (fuer Headless Commerce und Custom Storefronts) und Webhooks (fuer ereignisbasierte Echtzeit-Kommunikation). Dazu kommen Spezial-APIs wie die Functions API, die Multipass API und die Customer Privacy API.
Ueberblick: Welche Shopify APIs gibt es?
Shopify bietet Stand 2026 acht verschiedene APIs an, jede mit einem eigenen Einsatzbereich. Fuer die meisten Haendler und Entwickler sind vier davon entscheidend: Admin GraphQL, Admin REST (Legacy), Storefront und Webhooks. Die uebrigen vier sind Spezialfaelle.
| API-Typ | Protokoll | Zugriff | Typische Anwendung | Rate Limits |
|---|---|---|---|---|
| Admin GraphQL API | GraphQL | OAuth / Access Token | Produktverwaltung, Bestellungen, Kundendaten, Lager | 1.000 Cost Points, 50/s Regeneration |
| Admin REST API (Legacy) | REST / JSON | OAuth / Access Token | Einfache CRUD-Operationen, Legacy-Integrationen | 2 Calls/s (Standard), 20 Calls/s (Plus) |
| Storefront API | GraphQL | Storefront Access Token | Headless Commerce, Custom Storefronts, Mobile Apps | Separates Budget, abhaengig vom Plan |
| Webhooks | HTTP POST / EventBridge / Pub/Sub | HMAC-Signatur | Echtzeit-Events: Bestellung erstellt, Produkt aktualisiert | Kein klassisches Limit, 30s Timeout |
| Functions API | Wasm | App-Installation | Custom Discounts, Checkout-Validierung, Versandlogik | 10ms Ausfuehrungszeit |
| Ajax API | REST / JSON | Browser (kein Token) | Warenkorb-Interaktion im Frontend, ohne Page Reload | Clientseitig |
| Multipass API | Token-basiert | Multipass Secret | Single Sign-On fuer externe Login-Systeme | Shopify Plus exklusiv |
| Customer Privacy API | JavaScript | Browser | DSGVO-konforme Cookie-Einwilligung und Tracking-Kontrolle | Clientseitig |
Die entscheidende Frage ist nicht, welche API die beste ist. Sondern: Was willst du bauen? Fuer Backend-Integrationen (ERP, CRM, PIM, Lagerverwaltung) brauchst du die Admin GraphQL API. Fuer ein komplett eigenes Frontend die Storefront API. Fuer automatisierte Reaktionen auf Shop-Events die Webhooks.
Shopify Admin API: REST vs GraphQL
Die Admin API ist das Herzstueck jeder Shopify-Integration. Ueber sie verwaltest du Produkte, Bestellungen, Kunden, Lagerbestaende und praktisch alles, was im Backend deines Shops passiert. Seit 2024 gibt es sie in zwei Varianten: REST (Legacy) und GraphQL (Standard). Die Unterschiede sind erheblich.
GraphQL loest ein Problem, das REST-APIs strukturell haben: Over-Fetching. Bei REST fragst du einen Endpunkt ab und bekommst immer den kompletten Datensatz zurueck, auch wenn du nur den Produktnamen brauchst. Bei GraphQL definierst du exakt, welche Felder du willst. Das spart Bandbreite, reduziert die Antwortzeiten und macht komplexe Abfragen in einem einzigen Request moeglich, die bei REST drei oder vier separate Calls erfordern wuerden.
Produkt abrufen: REST vs GraphQL
Ein konkretes Beispiel zeigt den Unterschied. Du willst den Titel und den Preis eines Produkts abfragen.
[code block - coming soon][code block - coming soon]Der REST-Call liefert ein JSON-Objekt mit ueber 40 Feldern zurueck. Der GraphQL-Call liefert exakt zwei: Titel und Preis. Bei einer Integration, die tausende Produkte synchronisiert, summiert sich der Unterschied schnell.
| Kriterium | Admin REST API | Admin GraphQL API |
|---|---|---|
| Status (2026) | Legacy, keine neuen Features | Aktiver Standard |
| Datenabfrage | Feste Endpunkte, alle Felder | Flexible Queries, nur gewuenschte Felder |
| Rate Limits | 2 Calls/s (Standard), 20/s (Plus) | 1.000 Cost Points, 50/s Regeneration |
| Komplexe Abfragen | Mehrere Requests noetig | Ein Request reicht |
| Lernkurve | Niedrig, bekanntes REST-Pattern | Mittel, GraphQL-Syntax lernen |
| Bulk Operations | Nicht verfuegbar | Nativ unterstuetzt |
| Empfehlung | Nur fuer bestehende Legacy-Integrationen | Fuer alle neuen Projekte |
Shopify Storefront API und Headless Commerce
Die Storefront API ist Shopifys Antwort auf die Frage: Was, wenn dein Frontend nicht das Shopify-Theme sein soll? Sie liefert Produktdaten, Warenkorb-Funktionen und Checkout-Zugang als reine Daten-API, komplett losgeloest vom Shopify-Backend. Damit baust du beliebige Frontends, von React-Apps ueber Next.js-Websites bis zu nativen Mobile Apps.
In der Shopify-Welt heisst das Headless Commerce. Dein Shop hat keinen Kopf mehr (kein Shopify-Theme), nur noch einen Datenkoerper. Das Frontend baust du selbst oder nutzt Shopifys eigenes Headless-Framework Hydrogen, das auf React und Remix basiert und direkt auf Shopifys Hosting-Plattform Oxygen deployed wird. [URL PENDING]
Produkte, Kollektionen, Preise und Verfuegbarkeit als GraphQL-Endpunkt
React, Next.js, Hydrogen oder jedes andere Framework baut die Benutzeroberflaeche
Der sichere, PCI-konforme Shopify Checkout wird ueber die API eingebunden
Shopifys eigene Hosting-Plattform fuer Hydrogen-Storefronts mit globalem CDN
Wann lohnt sich Headless? Wenn du volle Designfreiheit brauchst, die Theme-Architektur an ihre Grenzen stoesst, oder du Omnichannel-Erlebnisse ueber mehrere Touchpoints bauen willst. Fuer einen Standard-Shop mit 200 Produkten ist ein Shopify-Theme in der Regel die bessere Wahl, weil der Entwicklungsaufwand deutlich geringer ist.
Shopify API einrichten: Schritt fuer Schritt
Die Einrichtung der Shopify API dauert unter 15 Minuten. Du brauchst entweder einen aktiven Shopify-Shop oder ein kostenloses Shopify Partner-Konto fuer die Entwicklung. Die offizielle Shopify API-Dokumentation beschreibt den Prozess im Detail. Hier ist der kuerzeste Weg zu deinem ersten API-Call. [URL PENDING]
- Shopify Partner-Konto erstellen: Gehe auf partners.shopify.com und registriere dich kostenlos. Als Partner kannst du Entwicklungs-Shops anlegen und Apps bauen, ohne einen kostenpflichtigen Plan zu brauchen.
- App im Partner Dashboard anlegen: Unter Apps erstellst du eine neue App. Waehle Custom App fuer eine private Integration oder Public App fuer den App Store. Fuer die meisten Integrationen (ERP, PIM, eigene Tools) reicht eine Custom App.
- API Credentials generieren: Nach dem Erstellen der App findest du unter API credentials deinen API Key und API Secret Key. Bei Custom Apps generierst du zusaetzlich einen Admin API Access Token mit den Scopes, die du brauchst (z.B. read_products, write_orders).
- Authentifizierung einrichten: Custom Apps nutzen einen festen Access Token im Header. Public Apps muessen den OAuth 2.0 Flow implementieren, bei dem der Haendler die App installiert und Berechtigungen erteilt. [URL PENDING]
- Ersten API-Call testen: Mit deinem Token kannst du direkt loslegen. Ein einfacher Test: Alle Produkte abfragen.
[code block - coming soon]Webhooks und Echtzeit-Daten
APIs arbeiten nach dem Pull-Prinzip: Du fragst Daten ab, wenn du sie brauchst. Webhooks sind das Gegenteil, ein Push-Mechanismus. Shopify schickt dir automatisch eine HTTP-Nachricht, sobald ein bestimmtes Event eintritt. Eine neue Bestellung, ein aktualisiertes Produkt, ein geloeschter Kunde.
Das erspart dir permanentes Polling (alle X Sekunden die API abfragen, ob sich etwas geaendert hat) und macht deine Integration schneller und ressourcenschonender. In der Praxis sind Webhooks die Grundlage fuer jede Echtzeit-Synchronisation zwischen Shopify und externen Systemen. [URL PENDING]
Die wichtigsten Webhook-Events
- orders/create und orders/paid: Neue Bestellung eingegangen, Zahlung bestaetigt. Kritisch fuer ERP-Synchronisation.
- products/update und products/create: Produktdaten geaendert oder neues Produkt angelegt. Wichtig fuer PIM- und Marktplatz-Anbindungen.
- customers/create: Neuer Kunde registriert. Relevant fuer CRM-Integration.
- inventory_levels/update: Lagerbestand geaendert. Basis fuer Lagerverwaltung und Verfuegbarkeitsanzeigen.
- app/uninstalled: Haendler hat deine App deinstalliert. Pflicht-Webhook fuer Public Apps.
[code block - coming soon]Praxisbeispiele: Shopify API Integrationen
Die Shopify API wird erst dann richtig wertvoll, wenn sie konkrete Geschaeftsprobleme loest. Hier sind die Integrationsszenarien, die wir in der Praxis am haeufigsten sehen.
ERP- und Warenwirtschafts-Anbindung
Die mit Abstand haeufigste API-Integration. Laut einer IHK-ibi-Handelsstudie nannten 2024 rund 15% der Online-Haendler mangelhaftes Schnittstellenmanagement als groesste Huerde im Tagesgeschaeft. Die Shopify Admin API loest das, indem sie Bestellungen, Lagerbestaende und Kundendaten automatisch mit ERP-Systemen wie WeClapp, Xentral oder Microsoft Dynamics synchronisiert.
KI-gestuetzte Produktberatung
Hier wird es fuer uns persoenlich. Qualimero nutzt die Shopify API, um KI-Mitarbeiter mit Echtzeit-Produktdaten zu versorgen. Der KI-Mitarbeiter kennt das gesamte Sortiment, aktuelle Verfuegbarkeiten und Preise, weil er ueber die Admin API permanent synchronisiert wird. Das Ergebnis bei unseren Kunden: Rasendoktor erzielte einen 16-fachen ROI durch KI-Produktberatung, Gartenfreunde steigerte die Conversion Rate um das 7-fache.
Rasendoktor mit KI-Mitarbeiter Hektor
Gartenfreunde mit KI-Mitarbeiterin Kira
Durchschnitt ueber Qualimero-Kunden
Rasendoktor, rund um die Uhr
Weitere Integrationsszenarien
- CRM-Integration: Kundendaten aus Shopify in Salesforce, HubSpot oder Pipedrive synchronisieren. Jede Bestellung wird zum CRM-Event.
- Marktplatz-Anbindung: Produkte und Bestaende parallel auf Amazon, eBay und dem eigenen Shop aktuell halten.
- Lagerverwaltung: Inventory Levels ueber Webhooks mit dem Lager synchronisieren. Kein manueller Abgleich mehr.
- Automatisierte Bestellabwicklung: Order Webhooks triggern Fulfillment, Rechnungserstellung und Versandlabel-Generierung.
- [Zapier-Integration fuer No-Code-Workflows](/blog/shopify-zapier-integration-ki-verkaufsberatung-guide): Shopify-Events ohne Programmierung mit ueber 5.000 Tools verbinden.
Die Shopify API liefert die Daten. Ein Qualimero KI-Mitarbeiter macht daraus personalisierte Produktberatung in Echtzeit. Unsere Kunden steigern den Warenkorbwert um bis zu 35%.
Kostenlose Demo buchenHaeufige Fehler und Best Practices
Nach ueber 25 Integrationen haben sich bestimmte Fehler als wiederkehrend herausgestellt. Die meisten davon sind vermeidbar, wenn du sie kennst.
- Rate Limits ignorieren: Der haeufigste Anfaengerfehler. Dein Code feuert hunderte Requests und wundert sich ueber 429-Fehler. Loesung: Implementiere einen Rate Limiter, der die verbleibenden Credits aus dem Response-Header liest und bei Bedarf wartet.
- Keine Webhook-Signatur-Validierung: Ohne HMAC-Pruefung kann jeder beliebige HTTP-Requests an deinen Endpoint schicken. Immer die Signatur validieren, ausnahmslos.
- Keine Retry-Logik bei Webhooks: Webhooks koennen fehlschlagen, dein Server war kurz offline, die Datenbank war ueberlastet. Shopify versucht es erneut, aber dein System muss idempotent sein: Dieselbe Bestellung darf nicht zweimal verarbeitet werden.
- API-Versionierung vergessen: Shopify veroeffentlicht vierteljaehrlich neue API-Versionen und entfernt alte nach 12 Monaten. Wenn du die Version in deinen Calls hardcodest und nie aktualisierst, bricht deine Integration irgendwann ohne Vorwarnung.
- Zu viele Scopes anfordern: write_all klingt bequem, ist aber ein Sicherheitsrisiko. Fordere nur die Berechtigungen an, die du wirklich brauchst.
FAQ: Shopify API
Ja, die Nutzung der Shopify API ist in jedem Shopify-Plan enthalten. Es fallen keine zusaetzlichen Kosten pro API-Call an. Die Rate Limits unterscheiden sich je nach Plan: Standard-Shops erhalten 2 REST-Calls pro Sekunde, Shopify Plus bis zu 20.
Jede Sprache, die HTTP-Requests senden kann. Shopify bietet offizielle SDKs fuer Node.js, Ruby, Python und PHP. Fuer andere Sprachen wie Go, Java oder C# nutzt du die REST- oder GraphQL-Endpunkte direkt ueber HTTP-Clients.
REST liefert feste Datensaetze ueber vordefinierte Endpunkte. GraphQL erlaubt dir, exakt die Felder abzufragen, die du brauchst, in einem einzigen Request. Seit Oktober 2024 ist REST Legacy, GraphQL ist der aktive Standard fuer alle neuen Entwicklungen.
Bei REST: 2 Calls pro Sekunde im Standard-Plan, 20 bei Shopify Plus. Bei GraphQL arbeitest du mit einem Budget von 1.000 Cost Points, die sich mit 50 Punkten pro Sekunde regenerieren. Die tatsaechlichen Kosten haengen von der Komplexitaet deiner Query ab.
Nicht direkt, die API erfordert technisches Verstaendnis. Aber es gibt Alternativen: Zapier, Make oder Shopify Flow erlauben dir, API-basierte Automatisierungen ohne Code zu bauen. Fuer komplexere Integrationen brauchst du einen Entwickler.
Entweder ueber das Shopify Admin unter Einstellungen, Benachrichtigungen, Webhooks, oder programmatisch ueber die Admin API. Fuer Produktiv-Integrationen ist der programmatische Weg besser, weil du die Webhook-Registrierung in deinen Deployment-Prozess einbauen kannst.
Shopify gibt einen HTTP 429 (Too Many Requests) zurueck. Deine Integration sollte den Retry-After-Header lesen und entsprechend warten. Bei wiederholten Verstoessen kann Shopify den Zugang temporaer sperren. Implementiere einen exponentiellen Backoff, um das zu vermeiden.
Du nutzt die Shopify API bereits oder planst eine Integration? Teste, wie ein KI-Mitarbeiter deine Produktdaten in Echtzeit-Beratung verwandelt. 14 Tage kostenlos.
Jetzt kostenlos testen