01Basisadresse 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_..."02Die 9 Endpunkte
| Endpunkt | Was es liefert |
|---|---|
GET /v1/apps | Die Apps, die dieses Konto trackt. Jeder andere Aufruf beginnt hier – die id stammt aus diesem. |
GET /v1/apps/{id} | Eine App plus der Snapshot des letzten Laufs. |
GET /v1/apps/{id}/keywords | Aktueller Rang pro getracktem Keyword in einer Storefront, mit Messzustand und durchsuchter Tiefe. |
GET /v1/apps/{id}/rivals | Die Apps, die über Ihnen stehen, jeweils mit den Begriffen, bei denen sie Sie schlagen, und beiden Positionen. |
GET /v1/apps/{id}/ai | Ob ein Assistent Ihre App für Ihre Kategorie nennt, mit der gespeicherten Reihe. Gemessen wird das in Studio. |
GET /v1/apps/{id}/history | Die Rangreihe pro Keyword, gekürzt auf das Verlaufsfenster des Tarifs. |
GET /v1/apps/{id}/page | Ihr eigener Eintrag, so wie der Store ihn ausliefert, beide Plattformen, plus die darauf erkannten datierten Änderungen. |
GET /v1/apps/{id}/reviews | Aktuelle Bewertungen mit Sterne-Übersicht, der Anzahl neuer in diesem Lauf und der Play-Seite, sofern gemessen. |
GET /v1/apps/{id}/charts | Chartposition für Genre und Storefront der App, mit der Reihe. |
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.
03Die drei Messzustände bleiben über die Schnittstelle hinweg erhalten
Diesen Teil sollten Sie lesen, bevor Sie die Integration schreiben. 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 in der gelesenen Tiefe nicht 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.
04Was sie nicht tut
- Sie schreibt nicht. Jeder Endpunkt ist
GET; alles andere liefertmethod_not_allowed. Es gibt keinen Weg von der API zu Ihrem Eintrag, Ihren getrackten Keywords oder Ihrer Abrechnung. - Sie misst nicht auf Abruf. Die Endpunkte lesen, was der nächtliche Lauf gesammelt hat. Zweimal zu fragen schickt keine zweite Anfrage an die Stores.
- Sie enthält die Umsatzebene nicht. Verbundene Konten (App Store Connect, Apple Ads, RevenueCat, GA4) bleiben im Dashboard – eine bewusste Grenze, kein Versehen.
- Der Verlauf wird nach Tarif gekürzt.
historyundchartsschneiden beide am Fenster des Tarifs ab; derselbe Schlüssel reicht also über keinen Endpunkt weiter zurück als über den anderen.
05Fehler
| 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. Die Antwort nennt den aktuellen Tarif. |
| 405 | method_not_allowed | Jeder Endpunkt ist GET. Nichts schreibt. |
| 404 | not_found | Diese App-ID gibt es in diesem Konto nicht. |
| 404 | unknown_endpoint | Kein solcher Pfad unter /v1. |
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?
Es gibt kein Kontingent pro Schlüssel. Das Gateway vor der API hat eine kontoweite Obergrenze, und jeder Aufruf aktualisiert 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?
Nein – API-Zugriff beginnt bei Pro. Die kostenlosen Tools auf dieser Website brauchen überhaupt kein Konto, und der kostenlose Tarif misst trotzdem 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 lesen dieselben Messungen.
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 25 Keywords in 2 Storefronts, 30 Tage Verlauf, ohne Karte und ohne Enddatum. Pro kostet $20/Monat.
Kostenlos starten →