Zum Inhalt springen

App Store Connect API

App Store Connect: Vendor-Nummer und salesReports-API

Jede Anfrage nach einem Verkaufsbericht an die App Store Connect API braucht eine Nummer, die die meisten Entwickler noch nie angesehen haben: die Vendor-Nummer. Hier steht, wo sie zu finden ist, welcher Schlüssel sie nutzen kann und wie Sie aus `GET /v1/salesReports` Verkäufe pro Land machen, mit denen sich arbeiten lässt.

Aktualisiert am 9 Min. Lesezeit

Wo Sie Ihre Vendor-Nummer in App Store Connect finden

Ihre Vendor-Nummer steht unter „Zahlungen und Finanzberichte“. Melden Sie sich in App Store Connect an, öffnen Sie „Zahlungen und Finanzberichte“, wählen Sie oben auf der Seite „Berichte“, und die Nummer erscheint oben links unter dem Namen Ihrer juristischen Person. Die API erwartet sie als filter[vendorNumber] (Apples Hilfe).

  1. Melden Sie sich in App Store Connect mit der Rolle Account Holder, Admin oder Finance an – den Rollen, die Apple für „Zahlungen und Finanzberichte“ nennt.
  2. Öffnen Sie „Zahlungen und Finanzberichte“.
  3. Wählen Sie oben auf der Seite „Berichte“.
  4. Lesen Sie die Vendor-Nummer oben links unter dem Namen Ihrer juristischen Person ab und kopieren Sie sie.

Zwei Abkürzungen. Wenn Sie schon einmal einen Verkaufsbericht unter Trends → Sales and Trends Reports heruntergeladen haben, steckt die Vendor-Nummer im Dateinamen: Tägliche Summary-Dateien heißen S_D_<vendor number>_<date>, zum Beispiel S_D_80012345_20130919 (Dateinamen der Berichte). Und wenn Sie nur die Rolle Sales haben, bitten Sie jemanden mit der Rolle Admin oder Finance, sie für Sie abzulesen, denn sie steht auf der Finanzseite.

Mehr als eine Vendor-Nummer

Das Menü neben Ihrem Vendor-Namen kann mehrere Vendor-Nummern auflisten. Apple vergibt eine neue, wenn Sie den Namen Ihrer juristischen Person ändern, und separate für Verträge zu Apple News+ oder Apple Arcade. Berichte werden nach Vendor-Nummer getrennt, nach einer Änderung des Firmennamens brauchen Sie also die neue Nummer für neue Verkäufe und die alte für die Historie.

Welche Rollen Verkaufsberichte lesen dürfen

Es geht um zwei verschiedene Berechtigungen: die Vendor-Nummer sehen („Zahlungen und Finanzberichte“) und Sales and Trends lesen. Der API-Schlüssel, der Berichte herunterlädt, braucht die zweite. Aus Apples Rollenberechtigungen und Hilfeseiten:

RolleSales-and-Trends-BerichteZahlungen und FinanzberichtePreise ändern
AdminJaJaJa
FinanceJaJaNein
SalesJaNeinNein
App ManagerVon Apple nicht aufgeführtNeinJa
Developer, Marketing, Customer SupportNeinNeinNein

Apple empfiehlt die Rolle Sales (in der API-Dokumentation „Sales and Reports“ genannt) für einen Schlüssel, den Sie an Dritte geben, die nur Berichte auswerten: Er kann GET /v1/salesReports aufrufen, aber nicht den Endpunkt für Finanzberichte (Apples Hinweis). Wenn ein Schlüssel sowohl Verkäufe lesen als auch Preise ändern muss, ist Admin die einzige Schlüsselrolle, die beides kann. Die Alternative sind zwei Schlüssel – App Manager für Preise, Sales für Berichte –, was aufgeräumter ist, wenn Ihr Tool das unterstützt. Wie Sie beide anlegen, steht in API-Schlüssel erstellen.

GET /v1/salesReports liefert jeden herunterladbaren Sales-and-Trends-Bericht. Jeder Typ akzeptiert nur bestimmte Kombinationen aus Untertyp, Häufigkeit und Version; alles andere ergibt einen Fehler. Die gültigen Kombinationen, aus Apples Endpunkt-Referenz:

reportTypereportSubTypefrequencyversion
SALESSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
PRE_ORDERSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
SUBSCRIPTIONSUMMARYDAILY1_3
SUBSCRIPTION_EVENTSUMMARYDAILY1_3
SUBSCRIBERDETAILEDDAILY1_3
SUBSCRIPTION_OFFER_CODE_REDEMPTIONSUMMARYDAILY1_0
WIN_BACK_ELIGIBILITYSUMMARYDAILY1_0
NEWSSTANDDETAILEDDAILY, WEEKLY1_0
FIRST_ANNUALDETAILED / SUMMARYDAILY / YEARLY1_0

Für Verkäufe nach Land ist SALES / SUMMARY der richtige Bericht: aggregierte Einheiten, Preise und Erlöse für Apps und In-App-Käufe, eine Zeile pro Produkt, Land, Preis und Transaktionstyp. Täglich ist die nützlichste Häufigkeit, weil sich aus Tagen jeder Zeitraum zusammensetzen lässt – und Tage brauchen Sie, um die Wirkung einer Preisänderung zu sehen.

Verkaufsbericht mit GET /v1/salesReports laden

ParameterPflichtWert für einen täglichen VerkaufsberichtHinweise
filter[vendorNumber]Ja85012345 (Ihre eigene)Aus „Zahlungen und Finanzberichte“.
filter[reportType]JaSALESWeitere Typen siehe Tabelle oben.
filter[reportSubType]JaSUMMARYMuss zum Berichtstyp passen.
filter[frequency]JaDAILYDAILY, WEEKLY, MONTHLY oder YEARLY.
filter[reportDate]Nein2026-11-09Apple dokumentiert YYYY-MM-DD und sagt, DAILY brauche kein Datum. Senden Sie trotzdem eines, damit Sie wissen, welchen Tag Sie bekommen haben.
filter[version]Nein1_0Die Version, die Apple für den Berichtstyp nennt.
  1. Erstellen Sie einen Team-API-Schlüssel mit der Rolle Admin, Finance oder Sales und bewahren Sie Issuer ID, Key ID und die .p8-Datei auf.
  2. Signieren Sie mit dem Schlüssel ein JWT (Tokens erzeugen). Bei den meisten Anfragen lehnt Apple Tokens ab, die länger als 20 Minuten gültig sind, erzeugen Sie also pro Stapel ein neues.
  3. Fordern Sie den Tag an: GET https://api.appstoreconnect.apple.com/v1/salesReports?filter[frequency]=DAILY&filter[reportType]=SALES&filter[reportSubType]=SUMMARY&filter[vendorNumber]=85012345&filter[reportDate]=2026-11-09&filter[version]=1_0, mit Authorization: Bearer <token> und Accept: application/a-gzip. Kodieren Sie die eckigen Klammern URL-konform, falls Ihr HTTP-Client das nicht tut.
  4. Der Body der 200-Antwort ist gzip (application/a-gzip). Entpacken Sie ihn – mit curl speichern Sie in eine Datei und führen gunzip darauf aus.
  5. Jetzt haben Sie tabulatorgetrennten Text: eine Kopfzeile, dann eine Zeile pro Produkt, Land, Preis und Transaktionstyp. Lesen Sie die Spalten nach Kopfzeilenname, nicht nach Position.
  6. Speichern Sie den Tag. Apple bewahrt tägliche Berichte nur ein Jahr auf; alles, was Sie von Jahr zu Jahr vergleichen wollen, müssen Sie bei sich ablegen.
  7. Wiederholen Sie das für jeden benötigten Tag und gehen Sie dabei haushälterisch vor: Jede Antwort enthält einen X-Rate-Limit-Header mit Ihren verbleibenden stündlichen Anfragen (Ratenbegrenzung).

Wöchentliche, monatliche und jährliche Berichte funktionieren genauso mit einer anderen Häufigkeit. Apples Dateinamen-Beispiele datieren einen Wochenbericht auf einen Sonntag und geben Monats- und Jahresdateien nur Monat oder Jahr – eine nützliche Kontrolle, welchen Zeitraum Sie erhalten haben. Bedenken Sie: 30 Tagesdateien ergeben einen Monat, den Sie beliebig aufschlüsseln können; eine Monatsdatei liefert keine Tage.

Das Dateiformat und die wichtigen Spalten

Die Feldreferenz des Summary Sales Reports dokumentiert jede Spalte (sie beschreibt Version 1_3 des Layouts; Apple ergänzt mit der Zeit Spalten, ein weiterer Grund, nach Kopfzeilennamen zuzuordnen). Die Spalten, die Sie für Verkäufe pro Land brauchen:

SpalteWas sie enthältWofür Sie sie nutzen
Apple IdentifierDie Apple-ID der App oder des In-App-KaufsZuordnung zu Ihren Produkten in der API
SKU / Parent IdentifierIhre SKU; bei In-App-Käufen ist der Parent Identifier die SKU der AppIn-App-Käufe unter ihrer App gruppieren
TitleApp-Name bei Downloads, Produkt-ID bei In-App-KäufenBeschriftungen
Product Type IdentifierDer Transaktionstyp, etwa 1F oder IAYDownloads, Käufe, Updates und erneute Downloads trennen
UnitsAggregierte Einheiten; negativ bei RückerstattungenDownloads und Käufe zählen
Developer ProceedsWas Sie pro Einheit erhalten, nach Steuern und Apples ProvisionErlöse = Units × Developer Proceeds
Customer Price / Customer CurrencyDer Preis pro Einheit, der dem Kunden berechnet wurde, und seine WährungPrüfen, was Kunden tatsächlich gezahlt haben
Country CodeZweibuchstabiger Code des App-Store-Landes oder der Region des KaufsDie Aufschlüsselung nach Land
Currency of ProceedsDie Währung des Developer-Proceeds-BetragsUmrechnen, bevor Sie Länder vergleichen
Subscription / PeriodNeu oder Verlängerung und die Laufzeit des AbonnementsNeue Abonnenten von Verlängerungen unterscheiden

Product Type Identifiers sortieren die Zeilen (vollständige Liste): 1, 1F, 1T und F1 sind App-Downloads, kostenlos oder kostenpflichtig; 3 und 3F sind erneute Downloads; 7, 7F, 7T und F7 sind Updates; IA1, IA9, IAY, FI1 und ihre -M-Varianten sind In-App-Käufe und Abonnements; IA3 ist ein wiederhergestellter nicht verbrauchbarer Kauf.

  • Developer Proceeds gilt pro Einheit. Multiplizieren Sie mit Units, bevor Sie Zeilen addieren.
  • Rückerstattungen haben negative Units und positive Developer Proceeds, sodass Units × Developer Proceeds sie korrekt abzieht.
  • Lassen Sie Updates und erneute Downloads weg, bevor Sie Downloads zählen – sie sind kostenlos und übersteigen die echten Downloads meist bei Weitem.
  • Dasselbe Produkt und Land kann in mehreren Zeilen auftauchen (verschiedene Preise, Geräte, Promo-Codes). Summieren Sie sie.
  • Tage laufen von Mitternacht bis Mitternacht Pacific Time, nicht UTC.
  • Beträge sind in lokalen Währungen. Rechnen Sie mit einem einheitlichen Kurssatz um, bevor Sie Länder in eine Rangfolge bringen; Verkäufe nach Land zeigt einen fairen Vergleich.

Wann Berichte bereitstehen und wie lange sie bleiben

Laut Apples Verfügbarkeitsseite sind tägliche Berichte am Folgetag verfügbar, wöchentliche montags, monatliche fünf Tage nach Monatsende und jährliche sechs Tage nach Jahresende, in der Regel bis 8 Uhr Pacific Time. Tägliche, wöchentliche und monatliche Berichte werden ein Jahr aufbewahrt, jährliche zehn Jahre. Ein Summary Sales Report existiert nur für einen Zeitraum mit mindestens einer verkauften App-Einheit, ein ruhiger Tag hat also schlicht keine Datei.

Häufige salesReports-Fehler

AntwortWas sie meist bedeutetWas zu tun ist
400 PARAMETER_ERROR.REQUIREDEin erforderlicher Filter fehlt, z. B. „The parameter 'filter[vendorNumber]' is required but was not provided“Senden Sie alle vier Pflichtfilter.
400 (andere)Eine Kombination, die Apple nicht anbietet – ein Untertyp, eine Häufigkeit oder eine Version, die nicht zum Berichtstyp passtPrüfen Sie Ihre Werte anhand der Tabelle mit den erlaubten Werten oben.
401 NOT_AUTHORIZEDDas Token ist fehlerhaft, abgelaufen oder mit einem widerrufenen Schlüssel signiertErzeugen Sie ein neues Token; prüfen Sie, ob Key ID, Issuer ID und .p8 zusammengehören.
403Die Rolle des Schlüssels darf keine Verkaufsberichte lesenVerwenden Sie einen Schlüssel mit der Rolle Admin, Finance oder Sales.
404Kein Bericht für dieses Datum: noch nicht veröffentlicht, an dem Tag nichts verkauft oder älter, als Apple aufbewahrtBehandeln Sie es als „keine Daten“, versuchen Sie neuere Tage später erneut.
429Das stündliche Limit für diesen Schlüssel ist erreichtWarten Sie und machen Sie dann weiter; verteilen Sie historische Downloads über die Zeit.
500 UNEXPECTED_ERRORDer Apple-Server ist ausgefallen. Als wir eine Vendor-Nummer sendeten, die nicht zum Team des Schlüssels gehörte, kam statt einer klaren Meldung genau das zurückVersuchen Sie es einmal erneut; wenn es bleibt, prüfen Sie zuerst die Vendor-Nummer.

Wie RepriceCat Ihre Vendor-Nummer nutzt

RepriceCat ändert Preise mit Ihrem App-Store-Connect-Schlüssel; mit Ihrer Vendor-Nummer kann es auch sehen, was diese Preise bewirken. Tragen Sie sie unter Einstellungen → Verkaufsberichte ein. Ihr Schlüssel braucht zum Lesen von Berichten die Rolle Admin, Finance oder Sales – also Admin, wenn derselbe Schlüssel auch Preise ändert. Ab dann lädt RepriceCat Apples tägliche SALES / SUMMARY-Berichte, jeden Tag einmal, und behält nur Tagessummen pro Produkt und Land. Updates und erneute Downloads bleiben außen vor.

  • Der Bildschirm „Sales“: Einheiten, Downloads, Käufe, Erlöse (in USD zu heutigen Kursen), Anteil und Trend pro Land, mit Weltkarte, Tages- und Wochentagsdiagrammen und Filtern nach App und Produkt.
  • Preishinweise, etwa Länder mit vielen Downloads, aber wenigen Käufen, oder solche, die weit häufiger kaufen als der Durchschnitt.
  • Wirkung jeder Preisänderung unter „Aktivität“: Einheiten und Erlöse vor und nach der Änderung, pro Produkt und Land.
  • Experimente: Ändern Sie den Preis in einigen Ländern, behalten Sie den Rest als Vergleich und behalten Sie das Ergebnis oder machen Sie es rückgängig (so führen Sie einen Preistest durch).

Wenn Sie das Skript zum Herunterladen und Auswerten nicht selbst pflegen möchten, vergleichen Sie RepriceCat mit API-Skripten oder starten Sie mit einem kostenlosen Monat.

Häufige Fragen

Wo finde ich meine Vendor-Nummer in App Store Connect?

Öffnen Sie „Zahlungen und Finanzberichte“, wählen Sie oben „Berichte“ und lesen Sie die Nummer oben links unter dem Namen Ihrer juristischen Person ab. Sie steht auch im Dateinamen jedes Verkaufsberichts, den Sie heruntergeladen haben, etwa S_D_80012345_20130919.

Ist die Vendor-Nummer dasselbe wie meine Team-ID oder die Apple-ID der App?

Nein. Die Vendor-Nummer ist an Ihre juristische Person in „Zahlungen und Finanzberichte“ gebunden. Team-ID und Apple-IDs der Apps sind eigene Kennungen und funktionieren nicht als filter[vendorNumber].

Welche Rolle braucht ein API-Schlüssel zum Herunterladen von Verkaufsberichten?

Admin, Finance oder Sales. App Manager kann Preise ändern, gehört aber nicht zu den Rollen, die Apple für Sales and Trends aufführt; ein einzelner Schlüssel, der beides können soll, braucht also Admin.

Warum liefert GET /v1/salesReports einen 404?

Für dieses Datum gibt es keinen Bericht: Der Tag ist noch nicht veröffentlicht, es wurde nichts verkauft, oder das Datum liegt über dem einen Jahr, das Apple tägliche Berichte aufbewahrt. Behandeln Sie es als „keine Daten“ und versuchen Sie neuere Tage später erneut.

Wie weit zurück kann ich App-Store-Verkaufsberichte herunterladen?

Tägliche, wöchentliche und monatliche Berichte werden ein Jahr lang nach ihrer Bereitstellung aufbewahrt, jährliche zehn Jahre. Speichern Sie die Dateien selbst, wenn Sie eine längere Tageshistorie brauchen.

Welche Version sollte ich für den täglichen Verkaufsbericht verwenden?

Apples Endpunkt-Referenz nennt für SALES und SUMMARY die Version 1_0. Lesen Sie die Datei nach Spaltennamen statt nach Positionen, weil Apple zwischen Layout-Versionen Spalten ergänzt.

Ausprobieren

Jedes Land aus einem Basispreis neu bepreisen

Preisstufen, Anpassung an Preispunkte, eine Prüftabelle, eine Bestätigung – über die App Store Connect API. Erster Monat gratis, danach 1 $ pro App und Monat.