Storelift

Storelift › Ratgeber › Die Storelift-API

KI-Ebene

Die Storelift-API

Alles, was das Dashboard zeigt, ist auch ein JSON-Endpunkt. 33 GET-Endpunkte lesen Ihre getrackten Apps und den Markt, und POST /v1/actions erstellt die Vorschau einer Änderung, die POST /v1/actions/confirm dann ausführt – ein Skript, ein Tabellen-Job oder ein CI-Schritt liest also dieselben Zahlen und handelt danach. Die vollständige Referenz finden Sie unter /docs/api/, die maschinenlesbare Spezifikation unter /openapi.json (OpenAPI 3.1); ein Assistent, der mit denselben Daten arbeitet, ist meist mit dem MCP-Server besser bedient, den jeder Tarif enthält.

Kostenlos starten →Kostenloser Tarif: 1 App, je 10 Keywords in 2 Storefronts, 14 Tage Verlauf, ohne Karte und ohne Enddatum. Pro kostet $29/Monat.

Von Aktualisiert: 9 Min. Lesezeit

Keyword-Tracking · Rangverlauf, die Bewegungen dieser Woche und verfolgte Keywords

Basisadresse und Authentifizierung

Die Basis ist https://storelift.net/v1. Erstellen Sie einen Schlüssel unter Einstellungen → API; er wird einmal angezeigt und nur als Hash gespeichert – ein verlorener Schlüssel wird also ersetzt, nicht wiederhergestellt.

Senden Sie ihn als x-api-key oder als Bearer-Token, falls Ihr Client nur Authorization-Header kennt:

Terminal
curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."
API-Zugriff gibt es in den Tarifen Pro und Studio – ab 29 $ im Monat, 99 $ für Studio. Der Schlüssel bleibt bei einem Downgrade erhalten; ein erneutes Upgrade belebt also dieselbe Integration wieder.

Die 33 Endpunkte

EndpunktWas es liefert
GET /v1/appsDie Apps, die dieses Konto trackt; die id jedes anderen Aufrufs stammt von hier.
GET /v1/apps/{id}Eine App plus der Snapshot des letzten Laufs.
GET /v1/apps/{id}/keywordsAktueller Rang pro getracktem Keyword in einer Storefront, mit Messzustand und durchsuchter Tiefe.
GET /v1/apps/{id}/rivalsDie Apps, die über Ihnen stehen, jeweils mit den Begriffen, bei denen sie Sie schlagen, und beiden Positionen.
GET /v1/apps/{id}/aiOb ein Assistent Ihre App für Ihre Kategorie nennt, mit der gespeicherten Reihe. Erfordert Pro, Studio oder Enterprise.
GET /v1/apps/{id}/historyDie Rangreihe pro Keyword, gekürzt auf das Verlaufsfenster des Tarifs.
GET /v1/apps/{id}/pageIhr eigener Eintrag, so wie der Store ihn ausliefert, beide Plattformen, plus die darauf erkannten datierten Änderungen.
GET /v1/apps/{id}/reviewsAktuelle Bewertungen mit Sterne-Übersicht, der Anzahl neuer in diesem Lauf und der Play-Seite, sofern gemessen. /reviews/search durchsucht das ganze Archiv nach Text, Sternen, Version und Datum; /reviews/stats liefert Verteilung, Tageskurve und Aufschlüsselung nach Version.
GET /v1/apps/{id}/timelineDatierte Änderungen am Eintrag – Version, Screenshots, Events, Featuring, Änderungen am Keyword-Feld – jeweils mit der Keyword-Rangbewegung drumherum.
GET /v1/apps/{id}/featuringEditorial-Karten, In-App Events und Apples „Das könnte dir auch gefallen“-Regal pro Land, mit datiertem Verlauf der Featurings und neuen Events.
GET /v1/apps/{id}/chartsChartposition für Genre und Storefront der App, mit der Reihe.
GET /v1/apps/{id}/revenueUmsatz und Downloads der App aus den verbundenen Quellen: Einheiten aus App Store Connect, Installationen aus Google Play, MRR, Abos und Testphasen aus RevenueCat. connected:false, wenn nichts verbunden ist. Scope revenue:read.
GET /v1/apps/{id}/subscriptionsAnzahl der Abo-Ereignisse aus dem Webhook von RevenueCat / Adapty, pro Tag, Land und Monatskohorte. Scope revenue:read.
GET /v1/apps/{id}/funnelApp-Store-Impressionen → Produktseitenaufrufe → Downloads: der heutige Wert und der tägliche Verlauf aus den App-Store-Connect-Analysen. Scope revenue:read.
GET /v1/apps/{id}/pricingAktuelle Preise pro Produkt und Land und jeder Festpreis-Zeitraum mit Testphasen, bezahlten Starts und Umsatz, dazu Angebotscodes – aus dem Webhook von RevenueCat / Adapty. Scope revenue:read.
GET /v1/apps/{id}/campaignsApple-Ads-Kampagnen, die für die App werben (zugeordnet über die App-Store-ID): Ausgaben, Taps, Installationen, Budget und Status, dazu die stärksten Keywords und Suchbegriffe. Scope ads:read.

Endpunkte unter /apps/{id} nehmen country entgegen (ein Storefront-Code wie us, standardmäßig das erste Land der App) und, wo beide Stores gemessen werden, platform=ios|android.

Die drei Messzustände bleiben über die Schnittstelle hinweg erhalten

Ein Rangfeld kann eine Zahl sein, aber das Fehlen einer Zahl bedeutet zwei verschiedene Dinge, und die API hält sie auseinander:

  • measured: true, rank: 7 – die App wurde auf Position 7 gefunden.
  • measured: true, rank: null – die Suche lief, und die App war bis searchDepth nicht in den Ergebnissen.
  • measured: false – die Suche konnte an diesem Tag nicht ausgeführt werden. Über die Position ist nichts bekannt.
JSON
{
  "country": "de",
  "platform": "ios",
  "live": true,
  "measuredAt": "2026-09-19T02:14:08.921Z",
  "keywords": [
    { "term": "traumdeutung", "measured": true,  "rank": 7,    "demand": 6, "searchDepth": 200 },
    { "term": "traumsymbole", "measured": true,  "rank": null, "demand": 3, "searchDepth": 200 },
    { "term": "traumtagebuch", "measured": false, "rank": null, "demand": null, "searchDepth": null }
  ]
}

Die letzten beiden zu einer Null zusammenzulegen, würde einen Einbruch beschreiben, der nie stattgefunden hat, und jeder Durchschnitt darauf wäre falsch. Braucht Ihr Code eine einzige Zahl, behandeln Sie measured: false als Lücke in der Reihe, nicht als Wert.

Konto, Nutzung und Suche

Vier Endpunkte über den Schlüssel selbst und die eigenen Datensätze des Kontos. Die ersten beiden kosten nichts, sodass ein Skript vor dem Start prüfen kann, was es lesen darf und wie viel übrig ist. search und fetch folgen der Form, die ChatGPT von einem Deep-Research-Connector erwartet: Eine Anfrage liefert IDs, eine ID liefert den Datensatz.

EndpunktWas es liefert
GET /v1/accountWem der Schlüssel gehört: Tarif, Authentifizierungsmethode, Scopes, lesbare Apps, Credit-Guthaben.
GET /v1/usageJedes Kontingent mit Verbrauch / Obergrenze / Zurücksetzung, das heutige Hive-Kontingent und die Rate pro Sekunde.
GET /v1/search?q=Durchsucht Ihre eigenen Apps, getrackten Keywords und Konkurrenten; liefert IDs für /v1/fetch.
GET /v1/fetch?id=Der vollständige Datensatz hinter einer Such-ID: App-Karte, ein Keyword mit Verlauf oder ein Konkurrent mit den Begriffen, bei denen er Sie schlägt.

Hive: jede App, jeder Markt

Die Endpunkte oben lesen Ihre eigenen getrackten Apps. Hive-Endpunkte lesen, was das gesamte Netzwerk misst – Charts, die Tagesmessung jeder App, Keyword-Ergebnislisten, die Keywords eines Konkurrenten sowie Umsatz und Downloads jeder App. Sie brauchen einen eigenen Scope am Schlüssel und kosten mehr Credits pro Aufruf; jeder Tarif hat außerdem ein tägliches Hive-Kontingent, damit ein Monat an Credits auch einen Monat reicht.

EndpunktWas es liefertScope
GET /v1/hive/charts?country=&kind=&genre=Die Liste Top-Gratis, Top-Umsatz oder iPad einer Storefront (100 tief), Stand des jüngsten Tags.hive:read
GET /v1/hive/apps/{storeId}?country=Die letzte Tagesmessung einer beliebigen App: Bewertungszahl, Bewertung, Version, Preis, Sterneverteilung, Kategorie-Badge, dazu unterstützte Sprachen, kommende In-App-Events, Werbetext und hervorgehobene In-App-Käufe.hive:read
GET /v1/hive/keywords/{term}/ranks?country=&days=&top=Wer bei einem Keyword gerankt hat, Tag für Tag (1.000 Zeilen pro Aufruf).hive:read
GET /v1/hive/spy/{storeId}?country=Die Keywords, für die ein Konkurrent rankt – mit demselben monatlichen Spy-Kontingent wie im Dashboard.hive:spy
GET /v1/hive/estimate/{storeId}?country=Monatlicher Umsatz und Downloads jeder App-Store-App, weltweit (202, solange die erste Abfrage läuft).hive:estimate
GET /v1/hive/movers?country=&kind=&genre=&days=&limit=Wer in einem Top-Chart gegenüber demselben Chart vor N Tagen gestiegen, gefallen, eingestiegen oder ausgestiegen ist. Jede Veränderung liegt zwischen zwei gemessenen Tagen, und die Antwort nennt beide.hive:read
GET /v1/hive/new?days=&country=&limit=Apps, die zum ersten Mal in einem Top-Chart gesehen wurden, die neuesten zuerst. Die Antwort sagt, wie viele dieser Tage der Index abdeckt.hive:read
GET /v1/hive/find?genre=&country=&kind=&released=&rankMin=&rankMax=&text=&publisher=&page=Findet Apps in den Charts, die wir messen: Filter nach Kategorie, Storefront, Chart (Top Grossing, Top Free, Top Paid, Top iPad), Rangbereich, Datum der ersten Sichtung, Name oder Publisher. Jede Zeile trägt Umsatz und Downloads der App.hive:read
GET /v1/hive/gap?ids=&country=&platform=Keyword-Lücke für bis zu fünf Apps nebeneinander: bei welchem Begriff welche App rankt und welche fehlt. Hive Explorer. Jede App trägt ihren eigenen Messzustand.hive:spy
GET /v1/hive/publisher/{publisherId}Jede App eines Publishers, die Hive gesehen hat, mit dem Tag, an dem sie zum ersten Mal in einem Chart stand.hive:read
GET /v1/hive/resolve?q=&country=&limit=Die ID jeder App aus Name, Entwickler, Store-Link, App-Store-ID oder Paketname. Namen laufen über die App-Store-Suche dieses Stores.hive:read
GET /v1/hive/similar/{storeId}?country=Das Ähnliche-Apps-Regal des Stores für jede App, in Regalreihenfolge, mit Kategorie und Name jeder App und dem Lesedatum.hive:read
GET /v1/hive/reviews/{storeId}?country=&limit=Die neuesten Bewertungen jeder App in einem Store mit Sterneverteilung; ohne Namen der Verfasser.hive:read

Persönliche Daten bleiben außen vor: Verfasser von Rezensionen erscheinen nie, und das Keyword eines Konkurrenten wird nur angezeigt, wenn mindestens zwei andere Konten es tracken oder Sie selbst.

Ohne Schlüssel ausprobieren

Jeden Pfad gibt es auch unter /v1/sandbox/, ganz ohne Schlüssel: dieselben Strukturen, ein fester Datensatz mit zwei Apps, Datumsangaben, die mit dem Vortag mitwandern. Antworten tragen x-sandbox: true. Für CI können Sie in den Einstellungen einen Test-Schlüssel (sl_test_) erstellen – er antwortet nur aus der Sandbox, verbraucht keine Credits und funktioniert in jedem Tarif, sodass ein geleakter Test-Schlüssel nichts preisgibt.

Terminal
curl -s https://storelift.net/v1/sandbox/apps
curl -s 'https://storelift.net/v1/sandbox/hive/keywords/sleep%20sounds/ranks?country=us&days=3&top=10'

Wie Schreibaktionen und Scopes funktionieren

  • Jede Schreibaktion bekommt zuerst eine Vorschau. POST /v1/actions liefert den Vorher-Nachher-Diff, die Credit-Kosten und ein Einmal-Token und ändert nichts; POST /v1/actions/confirm führt die Aktion aus. Das Token ist an die Aktion, die Argumente und den Zustand des Ziels zum Zeitpunkt der Vorschau gebunden: Hat sich das Ziel dazwischen bewegt, liefert die Bestätigung confirm_token_mismatch mit dem neuen Diff und schreibt nichts. Die Aktionen umfassen Keywords, Konkurrenten, Apps, Freigabelinks und Antworten auf Rezensionen (ab Pro) und in Studio Store-Texte in einer bearbeitbaren App-Store-Version sowie Pausieren, Fortsetzen und Tagesbudget in Apple Ads. Die vollständige Liste steht in der Referenz.
  • Schreib-Scopes wählen Sie selbst. Jede Schreibaktion braucht ihren Scope (track:write, reports:write, reviews:write, ads:write, listing:write); beim Erstellen eines Schlüssels sind sie nicht angekreuzt. Die Abrechnung bleibt in Ihren Kontoeinstellungen.
  • Prüfen Sie Datum und Status der Beobachtung. Eine Antwort kann eine gespeicherte Messung, ein bestätigtes Fehlen von Daten, ausstehende Arbeit oder einen Fehler enthalten. Eine erneute Anfrage macht eine ältere Beobachtung nicht aktuell.
  • Die Umsatzebene hat eigene Scopes. Die zehn Wachstums-Endpunkte (revenue, subscriptions, funnel, pricing, change-impact, campaigns, ads-keywords, ads-search-terms, ads-commands, search-popularity) antworten einem Schlüssel, der mit den sensiblen Scopes revenue:read / ads:read erstellt wurde – ein Schlüssel öffnet Umsatzdaten also nur, wenn Sie das wählen. GA4 liegt im Dashboard.
  • Der Verlauf folgt dem Tarif. history und charts nutzen beide das Fenster des Tarifs.

Fehler

StatuserrorWann
401missing_api_keyKein Schlüssel in der Anfrage.
401invalid_api_keyDer Schlüssel ist unbekannt oder wurde widerrufen.
401account_deletedDas Konto hinter dem Schlüssel existiert nicht mehr.
403plan_requiredDer Tarif enthält keinen API-Zugriff.
405method_not_allowedLesezugriffe sind GET; POST nehmen /v1/actions, /v1/actions/confirm und /v1/apps/{id}/validate-listing an (der Entwurf steht im Body).
400unknown_actionDer Aktionsname steht nicht im Katalog; die Antwort listet die vorhandenen auf.
400invalid_argumentsEin Argument fehlt oder ist fehlerhaft; die Antwort nennt das Feld.
409confirm_token_expiredDas Token ist älter als 10 Minuten. Erstellen Sie die Vorschau erneut.
409confirm_token_mismatchDas Ziel hat sich nach der Vorschau geändert; die Antwort enthält den neuen Diff.
403write_limit_reachedDie Schreibaktion liegt außerhalb der Leitplanken (Budgetschritt, tägliche Anzahl an Aktionen).
403test_key_read_onlyTest-Schlüssel schreiben nie.
404job_not_foundIn diesem Workspace gibt es keinen Job mit dieser ID.
403workspace_suspendedDer Workspace ist gesperrt; der Support kann den Grund nennen.
403ip_list_requiredDieser Workspace verlangt für jeden Schlüssel eine IP-Allowlist.
404not_foundDiese App-ID gibt es in diesem Konto nicht.
404unknown_endpointKein solcher Pfad unter /v1.
402credits_exhaustedDie Credits dieses Monats sind aufgebraucht; die Antwort verlinkt das Credit-Paket.
429rate_limitedZu viele Anfragen für diesen Schlüssel; warten Sie die Sekunden aus Retry-After ab.
429daily_hive_limitDas heutige Hive-Kontingent des Tarifs ist aufgebraucht; es wird um 00:00 UTC zurückgesetzt.
404not_measuredFür die angefragte App, das Keyword oder den Geltungsbereich liegt keine verifizierte Beobachtung vor. Fehlende Daten sind nicht null. Prüfen Sie die Anfrageparameter und die verlinkte Dokumentation zu verfügbaren Aktionen.
400bad_query/v1/search braucht ein q mit 1–120 Zeichen.
400bad_id/v1/fetch braucht eine ID genau so, wie /v1/search sie geliefert hat.
403asc_requiredupdate_listing braucht einen verbundenen App-Store-Connect-Schlüssel.
403asc_roleDer App-Store-Connect-Schlüssel braucht die Rolle Admin oder App Manager, um Metadaten zu bearbeiten.
409no_editable_versionKeine App-Store-Version ist bearbeitbar; die Antwort listet die aktuellen Versionsstatus auf.
404locale_not_foundDiese Storefront-Sprache ist in der Version nicht vorhanden; die Antwort listet die vorhandenen auf.
409changed_since_previewDer Eintrag wurde nach der Vorschau in App Store Connect geändert; nichts wurde geschrieben.
422asc_rejectedApp Store Connect hat die Änderung abgelehnt; die eigene Meldung steht in detail.
409in_progressFür dasselbe Ziel läuft noch eine Schreibaktion.
403ip_not_allowedDer Schlüssel hat eine IP-Allowlist, und diese Anfrage kam von anderswo.
401key_leakedDer Schlüssel wurde in einem öffentlichen Repository gefunden und automatisch widerrufen; erstellen Sie einen neuen.

Jeder Fehler ist JSON mit einem Feld error. plan_required liefert zusätzlich plan, sodass ein Client sagen kann, in welchem Tarif der Schlüssel ist, statt zu raten.

Häufige Fragen

Gibt es ein Rate-Limit?

Ja, pro Schlüssel: Anfragen pro Sekunde je nach Tarif (429 mit Retry-After), ein monatliches Credit-Kontingent, das in den Headern x-credits-* steht, und ein tägliches Hive-Kontingent. Jeder Aufruf aktualisiert außerdem einen Nutzungszähler am Schlüssel, sodass Sie in den Einstellungen sehen, ob ein alter Schlüssel noch verwendet wird.

Kann ich sie im kostenlosen Tarif nutzen?

Live-Schlüssel für die API gibt es ab Pro. Die Sandbox ohne Schlüssel und Test-Schlüssel funktionieren in jedem Tarif, der Remote-MCP-Server beginnt mit Pro, die kostenlosen Tools auf dieser Website brauchen überhaupt kein Konto, und der kostenlose Tarif misst täglich eine App.

API oder MCP-Server?

Ein Skript braucht die API: feste Strukturen, ein Aufruf, kein Modell dazwischen. Ein Assistent braucht den MCP-Server, weil die Tools ihre eigenen Beschreibungen mitbringen und er den richtigen Aufruf wählen kann, ohne dass Sie die Integration schreiben. Beide arbeiten mit denselben Messungen, und beide schreiben über denselben Schritt aus Vorschau und Bestätigung.

Prüfen Sie das für Ihre eigene App

Store-Link einfügen, Keywords hinzufügen. Ranking, die Apps vor Ihnen und die Nachfrage werden täglich gemessen.

Kostenloser Tarif: 1 App, je 10 Keywords in 2 Storefronts, 14 Tage Verlauf, ohne Karte und ohne Enddatum. Pro kostet $29/Monat.

Kostenlos starten →
Wettbewerber-Sets · die Begriffe, die Sie mit einem Wettbewerber teilen, und die, die nur er hat

Weiterlesen