App Store Connect API
Preise ändern mit der App Store Connect API
Alles, was die Preisbildschirme in App Store Connect können, steht auch über die API zur Verfügung. Das ist die Landkarte: welche Ressourcen es gibt, wie die Requests aussehen, wie viele Aufrufe eine weltweite Änderung braucht und was in der Praxis schiefgeht.
Die kurze Antwort
Um einen Preis mit der App Store Connect API zu ändern, rufen Sie die Preispunkte des Produkts für Ihr Basisland ab, wählen den Punkt für den neuen Preis und legen dann einen Preisplan an: POST /v1/appPriceSchedules für Apps, POST /v1/inAppPurchasePriceSchedules für In-App-Käufe oder pro Land ein POST /v1/subscriptionPrices für Abonnements. Authentifizieren Sie sich mit einem JWT, das ein Team-API-Schlüssel signiert.
Authentifizierung
Jede Anfrage trägt ein Bearer-JWT, das Sie mit dem privaten .p8-Schlüssel Ihres API-Schlüssels signieren (Apple: Tokens erzeugen):
- Header:
alg=ES256,kid= Ihre Key ID,typ=JWT. - Payload:
iss= Ihre Issuer ID,iat= jetzt,exp= höchstens 20 Minuten später,aud=appstoreconnect-v1. Ein optionalesscopekann ein Token auf aufgelistete GET-Anfragen beschränken. - Verwenden Sie ein Token für viele Anfragen wieder, bis es abläuft; Apple empfiehlt das aus Performancegründen. Lange Jobs erzeugen regelmäßig ein neues Token.
- Der Schlüssel braucht eine Rolle, die Preise verwalten darf: Admin oder App Manager (Apples Hilfeseiten nennen Account Holder, Admin oder App Manager als erforderliche Rolle). Wie Sie ihn erstellen, steht in der Anleitung zum API-Schlüssel.
Die Ressourcen
| Produkt | Preispunkte | Angleichungen | Preisänderung anlegen |
|---|---|---|---|
| App | `GET /v1/apps/{id}/appPricePoints`?filter[territory]=USA | `GET /v3/appPricePoints/{id}/equalizations` | `POST /v1/appPriceSchedules` – Basisland plus manuelle Preise |
| In-App-Kauf | `GET /v2/inAppPurchases/{id}/pricePoints` | `GET /v1/inAppPurchasePricePoints/{id}/equalizations` | `POST /v1/inAppPurchasePriceSchedules` – Basisland erforderlich |
| Abonnement | `GET /v1/subscriptions/{id}/pricePoints` – immer mit filter[territory] | `GET /v1/subscriptionPricePoints/{id}/equalizations` | `POST /v1/subscriptionPrices` – eines pro Land |
| Länder (Territories) | `GET /v1/territories` | — | Nur lesbar: die 175 Storefronts und ihre Währungen |
Jeder Preispunkt hat einen customerPrice und Ihre proceeds. Die Angleichungen (Equalizations) eines Punktes sind die passenden Punkte in jeder anderen Storefront – Apples weltweite Preise für diesen Basispreis, ohne dass Sie Wechselkurse rechnen müssen. Für Abonnements mit monatlichen und Vorauszahlungs-Plantypen dokumentiert Apple außerdem adjustedEqualizations (Apple: Abopreise über mehrere Länder konfigurieren). Den aktuellen Stand lesen Sie mit GET /v1/apps/{id}/appPriceSchedule und bei Abonnements mit GET /v1/subscriptions/{id}/prices.
Wie die Requests aussehen
Ein App-Preisplan ist ein einziges JSON:API-Dokument mit inline angelegten Preisen. Die Teile, auf die es ankommt:
| Wo | Feld | Wert |
|---|---|---|
data | type | appPriceSchedules |
data.relationships | app | Die ID Ihrer App |
data.relationships | baseTerritory | Zum Beispiel USA |
data.relationships | manualPrices | Verweise auf die Preise in included, mit temporären IDs wie ${price-1} |
included[] | type | appPrices (In-App-Käufe: inAppPurchasePrices) |
included[].attributes | startDate, endDate | null für „jetzt“ und „unbefristet“, oder ein Datum |
included[].relationships | appPricePoint | Die Preispunkt-ID für dieses Land |
Länder ohne manuellen Preis erhalten Apples automatischen, aus dem Basispreis abgeleiteten Preis. Ein Abopreis ist einfacher: type subscriptionPrices, Attribute startDate und preserveCurrentPrice (plus planType, wo Sie Plantypen anbieten) und Beziehungen zum Abonnement, zum Land und zum subscriptionPricePoint.
Eine weltweite Änderung, Schritt für Schritt
- Listen Sie die Länder einmal auf und cachen Sie sie; sie ändern sich selten.
- Rufen Sie für jedes Produkt die Preispunkte in Ihrem Basisland ab (200 pro Seite) und suchen Sie den, der Ihrem neuen Basispreis entspricht.
- Wenn Sie Apples Preise überall wollen, hören Sie hier auf: Für Apps und In-App-Käufe genügt der Basispunkt allein. Für eigene regionale Preise berechnen Sie pro Storefront einen Zielwert und lassen ihn einrasten – am einfachsten rasten Sie den Zielwert in der Basiswährung ein und folgen den Angleichungen dieses Punktes (wie das Einrasten funktioniert).
- Apps und In-App-Käufe: Senden Sie per POST einen Plan mit dem Basisland und allen manuellen Preisen. Abonnements: Senden Sie pro Storefront ein
subscriptionPricesper POST, mit Startdatum und Regelung für bestehende Abonnenten. - Behandeln Sie 429 und 5xx mit Backoff und Wiederholung; protokollieren Sie jede angelegte Ressource als Prüfpfad.
- Lesen Sie den Plan oder die Preise zurück und kontrollieren Sie einige Storefronts stichprobenartig in App Store Connect.
Wie viele Requests sind nötig?
Ein durchgerechnetes Beispiel: 2 Apps, 10 In-App-Käufe und 4 Abonnements, neu bepreist mit 4 regionalen Preisstufen. Apples Beispiel zum Rate Limit zeigt 3.500 Requests pro gleitender Stunde und Schlüssel und sagt, die tatsächlichen Limits variieren – lesen Sie bei jeder Antwort den Header X-Rate-Limit (Apple: Rate Limits).
| Schritt | Rechnung | Requests |
|---|---|---|
| Länder | Einmal | 1 |
| Basis-Preispunkte | 16 Produkte × etwa 5 Seiten | ≈ 80 |
| Angleichungen | 16 Produkte × 4 Stufenpunkte | ≈ 64 |
| App- und IAP-Preispläne | 12 Produkte × 1 | 12 |
| Abopreise | 4 Abonnements × 175 Storefronts | 700 |
| Gesamt | ≈ 857 |
Die Abonnements dominieren: Apple weist darauf hin, dass es keinen Bulk-Endpunkt gibt, um angeglichene Abopreise anzuwenden. Verdoppeln Sie den Katalog, rechnen Sie Wiederholungen und einen Prüfdurchlauf dazu, und Sie liegen nahe am Beispiel-Stundenlimit – takten Sie den Job also, statt eine enge Schleife abzufeuern.
Stolperfallen
- Ein POST auf einen Preisplan ersetzt den gesamten Plan der App oder des In-App-Kaufs. Nehmen Sie jeden manuellen Preis auf, den Sie behalten wollen, nicht nur die geänderten – was fehlt, fällt auf Apples automatischen Preis zurück.
- Um eine künftige Änderung bei einer App oder einem IAP zu planen, senden Sie die heutigen manuellen Preise mit einem
endDate, das dem neuenstartDateentspricht, gefolgt von den neuen Preisen. Zwei aufeinanderfolgende Intervalle mit demselben Preispunkt werden abgelehnt („Adjacent intervals cannot have the same price point“); senden Sie ein unverändertes Land also als einen unbefristeten Eintrag. - Abonnements behalten höchstens einen künftigen Preis pro Land. Löschen Sie den vorgemerkten mit `DELETE /v1/subscriptionPrices/{id}`, bevor Sie einen weiteren anlegen.
- Ein Abopreis ohne Startdatum ist der Anfangspreis. Sobald das Abonnement genehmigt ist, brauchen weitere Preise ein
startDate; sonst antwortet die API mit einem 409-Statusfehler. - Abosenkungen gelten für bestehende Abonnenten, und jede Abo-Änderung lässt sich nicht mehr zurücknehmen, sobald sie in Kraft ist. Erhöhungen brauchen eventuell Zustimmung – siehe Abopreis erhöhen.
- Preispunkt-Listen sind groß. Filtern Sie immer nach Land und paginieren Sie.
- Tokens gelten bei diesen Endpunkten höchstens 20 Minuten; lange Jobs müssen neu signieren.
- Änderungen können bis zu einer Stunde brauchen, bis sie in der Sandbox erscheinen.
- Nichts in der API fragt „Sind Sie sicher?“. Bauen Sie den Prüfschritt selbst.
Ein Preisskript sicher testen
Es gibt keine Staging-Kopie Ihres App-Store-Connect-Accounts, bauen Sie die Sicherheit also in das Skript selbst ein:
- Geben Sie dem Skript ein Dry-Run-Flag, das alles berechnet und eine Tabelle aus Produkt, Land, aktuellem Preis und neuem Preis ausgibt – und nichts sendet.
- Lesen Sie vor dem Schreiben den aktuellen Plan oder die Preise aus und vergleichen Sie sie mit Ihrem Plan; überspringen Sie Länder, die schon den Zielpreis haben.
- Führen Sie den ersten echten Schreibvorgang an einem Produkt aus, das noch nicht im Angebot ist, oder an einem einzelnen Land, und lesen Sie es zurück.
- Schreiben Sie pro Land eine Logzeile mit altem und neuem Preispunkt. Geht etwas schief, bringen Sie die Preise mit diesem Log zurück.
- Bewahren Sie den Schlüssel in einem Secret-Store auf, nie im Repository, und geben Sie dem Skript einen eigenen Schlüssel, damit Sie ihn unabhängig widerrufen können.
Das Skript sparen: RepriceCat
RepriceCat ist gewissermaßen dieser Leitfaden als Produkt. Sie verbinden Ihren eigenen Team-Schlüssel (verschlüsselt gespeichert, jederzeit widerrufbar), und es ruft Preispunkte ab, lässt Stufenpreise auf gültige Punkte einrasten, baut die Preispläne – einschließlich der Übernahme der heutigen Preise bei geplanten Änderungen – und taktet sich selbst gegen das Rate Limit.
- Eine Review-Tabelle Produkt × Land, heutiger Preis → neuer Preis, bevor etwas gesendet wird; ein Probelauf, der nichts sendet.
- Bis zu 200 Produkte über mehrere Apps in einer Änderung, sofort oder zu einem Datum.
- Fehlgeschlagene Länder mit Apples Begründung aufgelistet und einzeln erneut sendbar; jede Änderung pro Land protokolliert, mit Rollback.
- Tabellen-Roundtrip: Preise nach XLSX oder CSV exportieren, bearbeiten, zurückimportieren.
Selbst bauen oder kaufen? Lesen Sie RepriceCat vs. API-Skripte oder starten Sie mit einem kostenlosen Monat.
Häufige Fragen
Welche Rolle braucht ein App-Store-Connect-API-Schlüssel, um Preise zu ändern?
Admin oder App Manager. Apples Hilfeseiten zu Preisen nennen Account Holder, Admin oder App Manager als Rollen, die Preise verwalten dürfen; Schlüssel mit den Rollen Developer, Marketing, Sales oder Finance können es nicht.
Kann die API Preise für alle Länder in einem Request ändern?
Bei Apps und In-App-Käufen ja: Ein Preisplan trägt das Basisland und jeden manuellen Preis. Bei Abonnements ist jedes Land eine eigene subscriptionPrices-Ressource, eine weltweite Änderung sind also bis zu 175 Requests pro Abonnement.
Wie bekomme ich Apples angeglichene Preise über die API?
Suchen Sie den Preispunkt für Ihren Basispreis und rufen Sie dann seinen Equalizations-Endpunkt auf. Er liefert den vergleichbaren Preispunkt in jeder anderen Storefront, den Sie unverändert oder als eingerasteten Preis für eine regionale Preisstufe verwenden können.
Gibt es einen Sandbox- oder Dry-Run-Modus für Preisaufrufe?
Nein. Preispläne wirken auf den echten Account. Prüfen Sie den berechneten Stapel sorgfältig, testen Sie an einem Produkt, das noch nicht live ist, oder nutzen Sie ein Tool mit eigenem Probelauf.
Wie hoch ist das Rate Limit der App Store Connect API?
Die Limits gelten pro API-Schlüssel über eine gleitende Stunde und stehen im Header X-Rate-Limit jeder Antwort. Apples Beispiel zeigt 3.500 Requests pro Stunde, sagt aber, die tatsächlichen Limits variieren; bei Überschreitung kommt HTTP 429.
Wie breche ich eine geplante Preisänderung über die API ab?
Bei einem Abonnement löschen Sie die ausstehende subscriptionPrices-Ressource. Bei einer App oder einem In-App-Kauf senden Sie einen neuen Plan ohne den künftigen Eintrag – und denken daran, dass der POST den gesamten Plan ersetzt.
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.