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:
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."Die 33 Endpunkte
| Endpunkt | Was es liefert |
|---|---|
GET /v1/apps | Die Apps, die dieses Konto trackt; die id jedes anderen Aufrufs stammt von hier. |
GET | Eine App plus der Snapshot des letzten Laufs. |
GET | Aktueller Rang pro getracktem Keyword in einer Storefront, mit Messzustand und durchsuchter Tiefe. |
GET | Die Apps, die über Ihnen stehen, jeweils mit den Begriffen, bei denen sie Sie schlagen, und beiden Positionen. |
GET | Ob ein Assistent Ihre App für Ihre Kategorie nennt, mit der gespeicherten Reihe. Erfordert Pro, Studio oder Enterprise. |
GET | Die Rangreihe pro Keyword, gekürzt auf das Verlaufsfenster des Tarifs. |
GET | Ihr eigener Eintrag, so wie der Store ihn ausliefert, beide Plattformen, plus die darauf erkannten datierten Änderungen. |
GET | Aktuelle 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 | Datierte Änderungen am Eintrag – Version, Screenshots, Events, Featuring, Änderungen am Keyword-Feld – jeweils mit der Keyword-Rangbewegung drumherum. |
GET | Editorial-Karten, In-App Events und Apples „Das könnte dir auch gefallen“-Regal pro Land, mit datiertem Verlauf der Featurings und neuen Events. |
GET | Chartposition für Genre und Storefront der App, mit der Reihe. |
GET | Umsatz 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 | Anzahl der Abo-Ereignisse aus dem Webhook von RevenueCat / Adapty, pro Tag, Land und Monatskohorte. Scope revenue:read. |
GET | App-Store-Impressionen → Produktseitenaufrufe → Downloads: der heutige Wert und der tägliche Verlauf aus den App-Store-Connect-Analysen. Scope revenue:read. |
GET | Aktuelle 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 | Apple-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 bissearchDepthnicht in den Ergebnissen.measured: false– die Suche konnte an diesem Tag nicht ausgeführt werden. Über die Position ist nichts bekannt.
{
"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.
| Endpunkt | Was es liefert |
|---|---|
GET /v1/account | Wem der Schlüssel gehört: Tarif, Authentifizierungsmethode, Scopes, lesbare Apps, Credit-Guthaben. |
GET /v1/usage | Jedes Kontingent mit Verbrauch / Obergrenze / Zurücksetzung, das heutige Hive-Kontingent und die Rate pro Sekunde. |
GET | Durchsucht Ihre eigenen Apps, getrackten Keywords und Konkurrenten; liefert IDs für /v1/fetch. |
GET | 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.
| Endpunkt | Was es liefert | Scope |
|---|---|---|
GET | Die Liste Top-Gratis, Top-Umsatz oder iPad einer Storefront (100 tief), Stand des jüngsten Tags. | hive:read |
GET | 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 | Wer bei einem Keyword gerankt hat, Tag für Tag (1.000 Zeilen pro Aufruf). | hive:read |
GET | Die Keywords, für die ein Konkurrent rankt – mit demselben monatlichen Spy-Kontingent wie im Dashboard. | hive:spy |
GET | Monatlicher Umsatz und Downloads jeder App-Store-App, weltweit (202, solange die erste Abfrage läuft). | hive:estimate |
GET | 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 | 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 | 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 | 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 | Jede App eines Publishers, die Hive gesehen hat, mit dem Tag, an dem sie zum ersten Mal in einem Chart stand. | hive:read |
GET | 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 | Das Ähnliche-Apps-Regal des Stores für jede App, in Regalreihenfolge, mit Kategorie und Name jeder App und dem Lesedatum. | hive:read |
GET | 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.
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/actionsliefert den Vorher-Nachher-Diff, die Credit-Kosten und ein Einmal-Token und ändert nichts;POST /v1/actions/confirmfü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ätigungconfirm_token_mismatchmit 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 Scopesrevenue:read/ads:readerstellt wurde – ein Schlüssel öffnet Umsatzdaten also nur, wenn Sie das wählen. GA4 liegt im Dashboard. - Der Verlauf folgt dem Tarif.
historyundchartsnutzen beide das Fenster des Tarifs.
Fehler
| Status | error | Wann |
|---|---|---|
| 401 | missing_api_key | Kein Schlüssel in der Anfrage. |
| 401 | invalid_api_key | Der Schlüssel ist unbekannt oder wurde widerrufen. |
| 401 | account_deleted | Das Konto hinter dem Schlüssel existiert nicht mehr. |
| 403 | plan_required | Der Tarif enthält keinen API-Zugriff. |
| 405 | method_not_allowed | Lesezugriffe sind GET; POST nehmen /v1/actions, /v1 und /v1 an (der Entwurf steht im Body). |
| 400 | unknown_action | Der Aktionsname steht nicht im Katalog; die Antwort listet die vorhandenen auf. |
| 400 | invalid_arguments | Ein Argument fehlt oder ist fehlerhaft; die Antwort nennt das Feld. |
| 409 | confirm_token_expired | Das Token ist älter als 10 Minuten. Erstellen Sie die Vorschau erneut. |
| 409 | confirm_token_mismatch | Das Ziel hat sich nach der Vorschau geändert; die Antwort enthält den neuen Diff. |
| 403 | write_limit_reached | Die Schreibaktion liegt außerhalb der Leitplanken (Budgetschritt, tägliche Anzahl an Aktionen). |
| 403 | test_key_read_only | Test-Schlüssel schreiben nie. |
| 404 | job_not_found | In diesem Workspace gibt es keinen Job mit dieser ID. |
| 403 | workspace_suspended | Der Workspace ist gesperrt; der Support kann den Grund nennen. |
| 403 | ip_list_required | Dieser Workspace verlangt für jeden Schlüssel eine IP-Allowlist. |
| 404 | not_found | Diese App-ID gibt es in diesem Konto nicht. |
| 404 | unknown_endpoint | Kein solcher Pfad unter /v1. |
| 402 | credits_exhausted | Die Credits dieses Monats sind aufgebraucht; die Antwort verlinkt das Credit-Paket. |
| 429 | rate_limited | Zu viele Anfragen für diesen Schlüssel; warten Sie die Sekunden aus Retry-After ab. |
| 429 | daily_hive_limit | Das heutige Hive-Kontingent des Tarifs ist aufgebraucht; es wird um 00:00 UTC zurückgesetzt. |
| 404 | not_measured | Fü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. |
| 400 | bad_query | /v1/search braucht ein q mit 1–120 Zeichen. |
| 400 | bad_id | /v1/fetch braucht eine ID genau so, wie /v1/search sie geliefert hat. |
| 403 | asc_required | update_listing braucht einen verbundenen App-Store-Connect-Schlüssel. |
| 403 | asc_role | Der App-Store-Connect-Schlüssel braucht die Rolle Admin oder App Manager, um Metadaten zu bearbeiten. |
| 409 | no_editable_version | Keine App-Store-Version ist bearbeitbar; die Antwort listet die aktuellen Versionsstatus auf. |
| 404 | locale_not_found | Diese Storefront-Sprache ist in der Version nicht vorhanden; die Antwort listet die vorhandenen auf. |
| 409 | changed_since_preview | Der Eintrag wurde nach der Vorschau in App Store Connect geändert; nichts wurde geschrieben. |
| 422 | asc_rejected | App Store Connect hat die Änderung abgelehnt; die eigene Meldung steht in detail. |
| 409 | in_progress | Für dasselbe Ziel läuft noch eine Schreibaktion. |
| 403 | ip_not_allowed | Der Schlüssel hat eine IP-Allowlist, und diese Anfrage kam von anderswo. |
| 401 | key_leaked | Der 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 →
