Kurz gesagt: Eine API ist die Schnittstelle, über die Programme mit Ihrem Shopify-Shop reden, statt dass ein Mensch im Admin klickt. Shopify stellt dafür vor allem zwei APIs bereit: die Admin API für Back-Office-Daten wie Produkte, Bestellungen und Lager, und die Storefront API für das, was Kunden im Shop sehen. Wer Automatisierung aufsetzt, muss die API nicht selbst programmieren, denn Werkzeuge wie Shopify Flow, n8n oder fertige Apps nehmen Ihnen das ab. Aber die Grundbegriffe zu verstehen, hilft Ihnen, gute Entscheidungen zu treffen, Grenzen einzuschätzen und Fehler zu vermeiden, die sich sonst über jede Bestellung vervielfachen.
Dieser Artikel ist die Landkarte für das Thema Schnittstellen bei shopagentix. Er erklärt, welche APIs es gibt, was der Unterschied zwischen GraphQL und REST ist, warum Rate Limits für Automatisierung wichtig sind und wo Webhooks ins Spiel kommen. Für die einzelnen Bausteine verweisen wir an den passenden Stellen auf die Vertiefungen, etwa zu den Schnittstellen-Arten im Überblick, zum sauberen Datenmapping zwischen Systemen → und zur Frage, ob eine fertige App oder eine Eigenentwicklung → die bessere Wahl ist.
- Eine API ist die Schnittstelle, über die Software statt eines Menschen mit Shopify arbeitet.
- Shopify hat zwei Haupt-APIs: Admin API (Produkte, Bestellungen, Lager, Einstellungen) und Storefront API (kundenseitige Ansicht).
- GraphQL ist der heutige Standard, die REST Admin API gilt seit dem 1. Oktober 2024 als Legacy.
- Rate Limits begrenzen, wie viel eine Automatisierung pro Zeit abfragen darf. Bei GraphQL zählt die Kosten-Punktzahl, nicht die Anzahl der Aufrufe.
- Webhooks sind der umgekehrte Weg: Shopify meldet Ereignisse aktiv, statt dass Sie ständig nachfragen.
- Sie müssen die API nicht selbst bauen. Aber die Grundbegriffe zu kennen, verhindert teure Automatisierungsfehler.
01Was eine API überhaupt ist
API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Der Begriff klingt technischer, als die Idee dahinter ist. Eine API ist schlicht eine festgelegte Sprache, mit der ein Programm bei einem anderen etwas abfragen oder auslösen kann. Statt dass ein Mensch sich im Shopify-Admin einloggt und einen Lagerbestand von Hand ändert, schickt ein Programm eine klar definierte Anfrage an die API, und Shopify antwortet in einem ebenso klar definierten Format.
Für Sie als Händler bedeutet das: Alles, was Sie im Admin tun können, lässt sich über die API grundsätzlich auch automatisieren. Ein Lagersystem kann Bestände aktualisieren, eine Buchhaltung kann bezahlte Bestellungen abrufen, ein KI-Dienst kann Produkttexte zurückschreiben. Die API ist die Tür, durch die diese Systeme mit Ihrem Shop sprechen. Wie weit diese Tür offensteht, regeln Berechtigungen, also sogenannte Scopes, die genau festlegen, worauf ein angebundenes System zugreifen darf.
Wichtig für die richtige Erwartung: Sie als Händler müssen in aller Regel keine API-Aufrufe selbst schreiben. Automatisierungswerkzeuge sitzen zwischen Ihnen und der Schnittstelle. Shopify Flow → spricht die API im Hintergrund, der Shopify-Trigger in n8n → registriert Webhooks für Sie, und fertige Apps bringen ihre API-Anbindung mit. Die Grundbegriffe hier helfen Ihnen trotzdem, weil Sie damit verstehen, warum manche Automatisierung einfach ist und manche an eine Grenze stößt.
02Die zwei Haupt-APIs von Shopify
Shopify trennt sauber zwischen dem, was hinter den Kulissen passiert, und dem, was Kunden sehen. Daraus ergeben sich die zwei wichtigsten APIs.
Die Admin API ist die Schnittstelle für das Back-Office. Über sie verwalten Programme Produkte, Varianten, Bestände, Bestellungen, Kunden, Rabatte und Shop-Einstellungen. Fast jede operative Automatisierung läuft über die Admin API, weil hier die Daten liegen, mit denen Ihr Betrieb arbeitet. Der Zugriff ist geschützt und läuft serverseitig über ein Zugangs-Token oder OAuth, also nie offen im Browser (Shopify Dev-Doku).
Die Storefront API ist die kundenseitige Schnittstelle. Sie liefert das, was im Shop sichtbar ist: veröffentlichte Produkte, Kollektionen, Warenkorb und Checkout-Vorbereitung. Sie ist dafür gebaut, auch direkt aus dem Browser oder einer App aufgerufen zu werden, und dient vor allem sogenannten Headless-Setups, bei denen das Shop-Frontend nicht Shopifys Standard-Theme ist, sondern eine eigene Oberfläche (Shopify, Ecommerce API Guide).
Für die operative Automatisierung, um die es bei shopagentix geht, ist fast immer die Admin API relevant. Die Storefront API wird wichtig, wenn Sie ein eigenes Frontend bauen oder KI-Agenten Ihren Katalog auslesen. Für das Agenten-Thema gibt es mit UCP inzwischen einen eigenen Weg, den wir im Marken-Pillar zu agentischem Commerce auf Shopify → einordnen. Daneben existieren weitere, speziellere APIs, etwa für Kundenkonten oder Zahlungen, die für den Alltag der meisten Händler aber keine Rolle spielen.
03GraphQL oder REST: der heutige Standard
Wenn Sie sich mit der Shopify-API beschäftigen, stoßen Sie auf zwei Begriffe: GraphQL und REST. Beides sind Arten, wie eine Anfrage aufgebaut ist. Für Ihre Entscheidung zählt vor allem eines: GraphQL ist der heutige Standard, REST ist auf dem Rückzug.
Bei REST fragen Sie feste Endpunkte ab, etwa eine Adresse für Produkte und eine andere für Bestellungen. Jede Abfrage liefert einen kompletten Datensatz, auch Felder, die Sie gar nicht brauchen. Bei GraphQL stellen Sie eine einzige, gezielte Anfrage und beschreiben darin genau, welche Felder Sie zurückhaben wollen, auch über mehrere verknüpfte Objekte hinweg. Das ist präziser und spart Datenverkehr.
Die wichtige Nachricht für Ihre Planung: Shopify hat die REST Admin API am 1. Oktober 2024 zur Legacy-API erklärt. Seit dem 1. April 2025 müssen alle neuen öffentlichen Apps im Shopify App Store mit der GraphQL Admin API gebaut werden (Shopify Developer Changelog). Bestehende Apps dürfen REST vorerst weiter nutzen, aber die Richtung ist eindeutig.
Als Händler schreiben Sie diese Anfragen nicht selbst. Relevant wird der Punkt bei der Werkzeugwahl: Ein modernes Automatisierungswerkzeug oder eine aktuell gepflegte App setzt auf GraphQL. Wenn eine Integration oder eine Agentur noch ausschließlich auf die alte REST-Schnittstelle baut, ist das ein Hinweis, nach dem Wartungsstand zu fragen (Stand November 2026, bitte vor Umsetzung prüfen).
Für die reine Entscheidung, welches Werkzeug Sie einsetzen, ist das Thema kein Showstopper. Es hilft Ihnen aber einzuschätzen, ob eine Lösung zukunftssicher ist. Mehr zur Abgrenzung der verschiedenen Schnittstellen-Arten lesen Sie im Artikel Schnittstellen verstehen.
04Rate Limits: warum die API nicht unbegrenzt antwortet
Dieser Abschnitt ist für Automatisierung besonders wichtig, denn Rate Limits sind der häufigste Grund, warum eine Integration ins Stocken gerät. Ein Rate Limit ist eine Obergrenze, wie viel ein angebundenes System pro Zeit abfragen darf. Shopify schützt damit seine Server und sorgt dafür, dass ein einzelner Shop die Schnittstelle nicht überlastet.
Bei der GraphQL Admin API zählt dabei nicht die Anzahl der Aufrufe, sondern deren berechnete Kosten. Jede Anfrage hat eine Punktzahl, je nachdem, wie viele und wie komplexe Daten sie anfordert. Das System funktioniert wie ein undichter Eimer (Leaky Bucket): Ihr Kontingent füllt sich laufend wieder auf, kurze Lastspitzen sind erlaubt, solange der Dauerverbrauch im Rahmen bleibt.
Die Auffüllrate hängt also vom Shopify-Plan ab: 100 Punkte pro Sekunde im Standard-Plan, 200 bei Advanced und 1000 bei Shopify Plus, mit noch höheren Grenzen auf Enterprise-Ebene. Eine einzelne Anfrage darf dabei nie mehr als 1000 Punkte kosten, unabhängig vom Plan. Zur Einordnung der Kosten: Einfache Werte zählen 0 Punkte, ein Objekt 1 Punkt, Listenabfragen skalieren mit der Menge der zurückgegebenen Einträge, und schreibende Vorgänge (Mutations) kosten mindestens 10 Punkte (Shopify, GraphQL Admin API Rate Limits).
Für Sie heißt das konkret: Automatisierung, die in kurzer Zeit sehr viele Daten verarbeitet, etwa ein Massen-Update über tausende Produkte, muss die Grenzen respektieren und Pausen einlegen. Gute Werkzeuge und Apps tun das automatisch, indem sie Anfragen drosseln und bei Überschreitung warten. Wenn eine Integration bei großen Datenmengen plötzlich abbricht oder Fehler mit dem Code 429 (zu viele Anfragen) meldet, steckt fast immer ein Rate Limit dahinter. Wie Sie solche Abläufe stabil bauen, zeigt der Artikel zu zuverlässigen Integrationen.
05Webhooks: Shopify meldet sich von selbst
Bisher ging es um Anfragen, die Ihr System an Shopify schickt. Es gibt auch den umgekehrten Weg, und der ist für Automatisierung oft der elegantere. Ein Webhook kehrt die Richtung um: Statt dass Ihr System ständig nachfragt, ob es etwas Neues gibt, meldet sich Shopify von selbst, sobald ein Ereignis eintritt.
Technisch schickt Shopify bei einem passenden Ereignis, etwa einer neuen oder bezahlten Bestellung, automatisch die zugehörigen Daten an eine URL, die Sie vorher hinterlegt haben. Das spart unnötige Abfragen und reagiert in Echtzeit. Der Unterschied zum ständigen Nachfragen (Polling) ist erheblich: Polling verbraucht Rate-Limit-Budget auch dann, wenn nichts passiert, während ein Webhook nur dann feuert, wenn wirklich etwas geschieht.
Webhooks sind damit die Brücke zwischen Ihrem Shop und externen Systemen und das Fundament vieler Automatisierungen. Weil das Thema eigene Sicherheits- und Zuverlässigkeitsregeln hat, behandeln wir es ausführlich im Artikel Shopify-Webhooks verstehen und nutzen. Die zwei Kernregeln vorweg: Prüfen Sie die Signatur jeder Nachricht, und planen Sie ein, dass eine Nachricht mehrfach ankommen kann.
06Wie Daten zwischen Systemen zusammenpassen müssen
Eine API verbindet zwei Systeme technisch. Damit die Verbindung auch inhaltlich funktioniert, müssen die Daten auf beiden Seiten zusammenpassen. Shopify nennt ein Feld vielleicht "Varianten-SKU", Ihr Lagersystem nennt dasselbe "Artikelnummer", und Ihre Buchhaltung erwartet wieder ein anderes Format. Diese Übersetzung zwischen den Feldern heißt Datenmapping und entscheidet darüber, ob eine Integration saubere oder chaotische Ergebnisse liefert.
Datenmapping ist unspektakulär und wird deshalb oft unterschätzt. Dabei entstehen die meisten stillen Fehler genau hier: ein Datum im falschen Format, ein Preis mit Komma statt Punkt, ein Pflichtfeld, das leer bleibt. Weil ein Automatisierungsfehler sich über jede Bestellung oder jedes Produkt wiederholt, lohnt es sich, dieses Thema ernst zu nehmen. Wie Sie Felder zwischen Systemen sauber zuordnen und typische Stolperstellen vermeiden, zeigt der Artikel zu Datenmapping und Feldzuordnung →.
Ein verwandtes Thema sind Metafields, also Zusatzfelder, mit denen Sie Shopify-Objekte um eigene Eigenschaften erweitern. Sie sind häufig genau die Stelle, an der Daten aus Fremdsystemen landen. Wie Sie Metafields sinnvoll aufbauen, lesen Sie im Artikel zu Produktattributen und Metafields →.
07Was Sie mit diesem Wissen entscheiden können
Sie müssen die Shopify-API nicht programmieren, um sie sinnvoll zu nutzen. Aber mit den Grundbegriffen treffen Sie bessere Entscheidungen. Drei Fragen tauchen in der Praxis immer wieder auf.
Die wichtigste Erkenntnis: Die API ist ein Werkzeug, kein Selbstzweck. Für die meisten Automatisierungen sitzt zwischen Ihnen und der Schnittstelle ein Werkzeug, das die technischen Details übernimmt. Ihre Aufgabe ist es, die richtige Ebene zu wählen. Reicht eine native Automatisierung im Shop, brauchen Sie ein system-übergreifendes Werkzeug, oder lohnt sich eine eigene Anbindung? Diese letzte Frage beantwortet der Artikel Fertige App oder Eigenentwicklung →.
08Trust und Sicherheit: die Schnittstelle verantwortungsvoll öffnen
Eine API ist eine Tür in Ihren Shop, und Türen sollte man bewusst öffnen. Jede Anbindung bekommt nur die Berechtigungen, die sie wirklich braucht. Ein Werkzeug, das Bestände synchronisiert, benötigt keinen Zugriff auf Kundendaten. Wenn Sie eine App oder eine Integration einrichten, lohnt ein Blick darauf, welche Scopes sie anfordert.
Zugangsdaten und Tokens sind Geheimnisse. Sie gehören nie offen in einen Workflow, in eine E-Mail oder in ein geteiltes Dokument, sondern in die dafür vorgesehene, geschützte Ablage des jeweiligen Werkzeugs. Und schließlich gilt für jede Automatisierung die Grundhaltung dieser Marke: Bauen Sie Prüfschritte und, bei kritischen Vorgängen, eine menschliche Freigabe ein. Eine Schnittstelle, die automatisch schreibt, vervielfacht nicht nur Arbeit, sondern auch Fehler. Wer das von Anfang an mitdenkt, nutzt die Shopify-API als das, was sie sein soll: ein verlässlicher, kontrollierter Weg, wiederkehrende Arbeit abzugeben. Die konkreten Bausteine dafür, also Wiederholungen (Retries), Idempotenz und Überwachung, vertieft der Artikel zu zuverlässigen Integrationen.
FAQHäufige Fragen
Muss ich programmieren können, um die Shopify-API zu nutzen? +
Nein. Für die allermeisten Automatisierungen sitzt ein Werkzeug zwischen Ihnen und der API. Shopify Flow, n8n oder fertige Apps sprechen die Schnittstelle im Hintergrund an, Sie konfigurieren nur den Ablauf. Programmierkenntnisse brauchen Sie erst, wenn Sie eine eigene Anbindung bauen oder sehr spezielle Logik abbilden wollen.
Was ist der Unterschied zwischen Admin API und Storefront API? +
Die Admin API verwaltet das Back-Office, also Produkte, Bestellungen, Lager und Einstellungen, und läuft geschützt auf dem Server. Die Storefront API liefert die kundenseitige Ansicht wie Katalog und Warenkorb und ist dafür gebaut, auch öffentlich im Browser genutzt zu werden. Für operative Automatisierung ist fast immer die Admin API relevant.
Soll ich auf GraphQL oder REST setzen? +
GraphQL ist der heutige Standard. Shopify hat die REST Admin API am 1. Oktober 2024 zur Legacy-API erklärt, und neue öffentliche Apps müssen seit dem 1. April 2025 GraphQL nutzen (Shopify Changelog). Als Händler wählen Sie die Schnittstelle nicht direkt, aber ein modernes Werkzeug oder eine aktuelle App setzt auf GraphQL.
Was sind Rate Limits und warum bremsen sie meine Automatisierung? +
Rate Limits sind Obergrenzen, wie viel ein System pro Zeit abfragen darf. Bei GraphQL zählt die Kosten-Punktzahl der Anfragen, nicht ihre Anzahl, mit einer Auffüllrate je nach Plan (Shopify Rate Limits). Massen-Updates stoßen deshalb an Grenzen. Gute Werkzeuge drosseln automatisch und wiederholen Anfragen, statt abzubrechen.
Brauche ich Webhooks für Automatisierung? +
Oft ja. Ein Webhook meldet ein Ereignis in Echtzeit, statt dass Ihr System ständig nachfragt, und spart damit Rate-Limit-Budget. Für die Anbindung externer Systeme in Echtzeit sind Webhooks der Standard. Die Details und zwei Pflichtregeln dazu stehen im Artikel zu Shopify-Webhooks.
Ist es gefährlich, meinen Shop per API zu öffnen? +
Nicht, wenn Sie es bewusst tun. Geben Sie jeder Anbindung nur die Berechtigungen, die sie wirklich braucht, bewahren Sie Zugangsdaten geschützt auf und bauen Sie bei kritischen Vorgängen eine Prüf- oder Freigabestufe ein. Eine kontrollierte, verstandene Anbindung ist sicher. Riskant wird es erst, wenn automatisch geschrieben wird, ohne dass jemand die Ergebnisse prüft.
Bleib dran bei deinem Shop
Jede Woche eine kurze, verständliche Mail mit dem, was für Einsteiger wirklich zählt.
Geschrieben von der Redaktion shopagentix. shopagentix ist ein Angebot der RIANTHIS GmbH.