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.
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).
- 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.
- Öffnen Sie „Zahlungen und Finanzberichte“.
- Wählen Sie oben auf der Seite „Berichte“.
- 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:
| Rolle | Sales-and-Trends-Berichte | Zahlungen und Finanzberichte | Preise ändern |
|---|---|---|---|
| Admin | Ja | Ja | Ja |
| Finance | Ja | Ja | Nein |
| Sales | Ja | Nein | Nein |
| App Manager | Von Apple nicht aufgeführt | Nein | Ja |
| Developer, Marketing, Customer Support | Nein | Nein | Nein |
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.
Berichtstypen in Sales and Trends
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:
| reportType | reportSubType | frequency | version |
|---|---|---|---|
SALES | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
PRE_ORDER | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
SUBSCRIPTION | SUMMARY | DAILY | 1_3 |
SUBSCRIPTION_EVENT | SUMMARY | DAILY | 1_3 |
SUBSCRIBER | DETAILED | DAILY | 1_3 |
SUBSCRIPTION_OFFER_CODE_REDEMPTION | SUMMARY | DAILY | 1_0 |
WIN_BACK_ELIGIBILITY | SUMMARY | DAILY | 1_0 |
NEWSSTAND | DETAILED | DAILY, WEEKLY | 1_0 |
FIRST_ANNUAL | DETAILED / SUMMARY | DAILY / YEARLY | 1_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
| Parameter | Pflicht | Wert für einen täglichen Verkaufsbericht | Hinweise |
|---|---|---|---|
filter[vendorNumber] | Ja | 85012345 (Ihre eigene) | Aus „Zahlungen und Finanzberichte“. |
filter[reportType] | Ja | SALES | Weitere Typen siehe Tabelle oben. |
filter[reportSubType] | Ja | SUMMARY | Muss zum Berichtstyp passen. |
filter[frequency] | Ja | DAILY | DAILY, WEEKLY, MONTHLY oder YEARLY. |
filter[reportDate] | Nein | 2026-11-09 | Apple dokumentiert YYYY-MM-DD und sagt, DAILY brauche kein Datum. Senden Sie trotzdem eines, damit Sie wissen, welchen Tag Sie bekommen haben. |
filter[version] | Nein | 1_0 | Die Version, die Apple für den Berichtstyp nennt. |
- 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. - 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.
- 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, mitAuthorization: Bearer <token>undAccept: application/a-gzip. Kodieren Sie die eckigen Klammern URL-konform, falls Ihr HTTP-Client das nicht tut. - Der Body der 200-Antwort ist gzip (
application/a-gzip). Entpacken Sie ihn – mit curl speichern Sie in eine Datei und führengunzipdarauf aus. - 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.
- 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.
- 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:
| Spalte | Was sie enthält | Wofür Sie sie nutzen |
|---|---|---|
| Apple Identifier | Die Apple-ID der App oder des In-App-Kaufs | Zuordnung zu Ihren Produkten in der API |
| SKU / Parent Identifier | Ihre SKU; bei In-App-Käufen ist der Parent Identifier die SKU der App | In-App-Käufe unter ihrer App gruppieren |
| Title | App-Name bei Downloads, Produkt-ID bei In-App-Käufen | Beschriftungen |
| Product Type Identifier | Der Transaktionstyp, etwa 1F oder IAY | Downloads, Käufe, Updates und erneute Downloads trennen |
| Units | Aggregierte Einheiten; negativ bei Rückerstattungen | Downloads und Käufe zählen |
| Developer Proceeds | Was Sie pro Einheit erhalten, nach Steuern und Apples Provision | Erlöse = Units × Developer Proceeds |
| Customer Price / Customer Currency | Der Preis pro Einheit, der dem Kunden berechnet wurde, und seine Währung | Prüfen, was Kunden tatsächlich gezahlt haben |
| Country Code | Zweibuchstabiger Code des App-Store-Landes oder der Region des Kaufs | Die Aufschlüsselung nach Land |
| Currency of Proceeds | Die Währung des Developer-Proceeds-Betrags | Umrechnen, bevor Sie Länder vergleichen |
| Subscription / Period | Neu oder Verlängerung und die Laufzeit des Abonnements | Neue 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
| Antwort | Was sie meist bedeutet | Was zu tun ist |
|---|---|---|
400 PARAMETER_ERROR.REQUIRED | Ein 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 passt | Prüfen Sie Ihre Werte anhand der Tabelle mit den erlaubten Werten oben. |
401 NOT_AUTHORIZED | Das Token ist fehlerhaft, abgelaufen oder mit einem widerrufenen Schlüssel signiert | Erzeugen Sie ein neues Token; prüfen Sie, ob Key ID, Issuer ID und .p8 zusammengehören. |
| 403 | Die Rolle des Schlüssels darf keine Verkaufsberichte lesen | Verwenden Sie einen Schlüssel mit der Rolle Admin, Finance oder Sales. |
| 404 | Kein Bericht für dieses Datum: noch nicht veröffentlicht, an dem Tag nichts verkauft oder älter, als Apple aufbewahrt | Behandeln Sie es als „keine Daten“, versuchen Sie neuere Tage später erneut. |
| 429 | Das stündliche Limit für diesen Schlüssel ist erreicht | Warten Sie und machen Sie dann weiter; verteilen Sie historische Downloads über die Zeit. |
500 UNEXPECTED_ERROR | Der 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ück | Versuchen 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.