Endpunkte für Ihre Apps

GET /apps

Listet die in diesem Storelift-Konto verfolgten Apps (ID, Name, Länder, Keywords). Zuerst aufrufen — jedes andere Tool braucht eine appId von hier.

Scope

apps:read

Credits

1

Plan

Free

curl "https://storelift.net/v1/apps" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/keywords

Keyword-Platzierungen einer App in einem Land des App Store / von Google Play. DREI ZUSTÄNDE SIND ZU UNTERSCHEIDEN: measured=false heißt, die Suchanfrage konnte nicht gemessen werden; rank=null heißt, sie wurde gemessen, aber die App fehlt in den obersten Ergebnissen; rank=<Zahl> ist der Platz. Fassen Sie sie nie zusammen — einen nicht gemessenen Tag als null zu zählen ergibt eine falsche Antwort.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/keywords?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/rivals

Apps, die in der Suche VOR dieser App ranken. Zu jedem Wettbewerber erhalten Sie die Keywords, bei denen er vor Ihnen liegt, seinen Platz dort (theirRank) und Ihren (ourRank) — ourRank null heißt, die App erscheint für dieses Keyword gar nicht.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/ai

App-Nennungen in einer datierten Stichprobe von Antworten der KI-Engines; das gibt nicht wieder, was ChatGPT, Claude oder Gemini jedem Nutzer zeigen. Erforderlich sind Studio oder Enterprise und der Bereich ai:read. engines enthält die Antworten jeder gemessenen Engine; providers gibt die Zustände measured, failed oder not_measured an. Eine nicht verfügbare Engine ist kein Wert von null. Lesen Sie die datierte Stichprobe und ihre Fragenzahl; sie ist kein allgemeingültiges Ranking und kein Maß für alle Verbraucherantworten.

Scope

ai:read

Credits

1

Plan

Studio

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/ai?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/ai-check

Startet für eine App in einem Land eine KI-Sichtbarkeits-Stichprobe mit den für den Lauf verfügbaren Engines. Erfordert Studio oder Enterprise und den Bereich ai:read; das Dashboard-Kontingent von Pro gibt keinen Zugriff auf dieses MCP-Tool. Verbraucht einen KI-Sichtbarkeitslauf aus dem Tarif oder aus einem Zukauf; get_ai_visibility liefert das Ergebnis. Pro App läuft jeweils nur eine Messung.

Scope

ai:read

Credits

1

Plan

Studio

Nimmt außerdem: appId (erforderlich)

Dieser Aufruf verbraucht eine KI-Sichtbarkeits-Messung aus dem Plan oder aus einem Kauf, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/history

Ranking-Verlauf der Keywords für ein Land. Die Punkte der Reihe sind [Tag, Platz]; ein Platz null heißt, die App fehlte an diesem Tag in den obersten Ergebnissen — das ist nicht dasselbe wie ein schlechter Platz. Pro-Tarif.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/page

Die Signale der eigenen Produktseite der App für ein Land (Name und Untertitel sind nicht enthalten): Version, In-App-Events, redaktionelle Platzierungen, Regale mit ähnlichen Apps und das Screenshot-Set (iOS), dazu die Google-Play-Seite (genaue Installationszahl, Bewertungsverteilung, Kennzeichen für Werbung/In-App-Käufe, Chart-Abzeichen). ios.listingExtras enthält die Sprachen, die die App unterstützt, ihre Sterneverteilung (1★ bis 5★), laufende und kommende In-App-Events, den Werbetext und die hervorgehobenen In-App-Käufe; in Free kommen die Zahl der Sprachen, die ersten 5 Sprachen und die Sterneverteilung mit, und locked zeigt, wie viele es vom Rest gibt. timeline listet die datierten Änderungen, die wir an der Produktseite erkannt haben — die günstigste Erklärung für eine Ranking-Bewegung. measured=false heißt, die Seite wurde nie gelesen; das ist nicht dasselbe wie eine leere Seite.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/page?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/reviews

Aktuelle Rezensionen für ein Land: list enthält die App-Store-Rezensionen, android die Google-Play-Rezensionen (ein kürzeres Fenster), jeweils mit Text, Bewertung und Datum. newCount gibt an, wie viele seit der vorherigen Messung hinzugekommen sind; bei einem älteren Eintrag kommt null — lesen Sie das als unbekannt, nicht als null. android: null heißt, diese Play-Seite wartet auf ihre erste Messung, und eine leere Liste heißt, die Seite hat keine Rezensionen.

Scope

reviews:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/reviews?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/charts

Chart-Position im App Store für ein Land: aktuelle Plätze je Liste (gratis / bezahlt / umsatzstärkste, gesamt und in der Kategorie) samt Verlauf. Google Play fehlt mit Absicht — es hat keine öffentliche Top-Liste, und eine Zahl hier wäre erfunden.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/reviews/search

Durchsucht die Rezensionen einer App in einem Storefront nach Text, Sternebewertung, App-Version und Zeitraum, das Neueste zuerst — bis zu 1.000 Zeilen aus dem vollständigen Rezensionsarchiv innerhalb des Rezensionsfensters Ihres Tarifs. total ist die Zahl der Treffer; truncated zeigt an, wenn mehr Zeilen passten, als Sie angefordert haben.

Scope

reviews:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/reviews/search?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/reviews/stats

Sterneverteilung, Durchschnitt und Anteil der Rezensionen mit 1–2 Sternen für eine App in einem Storefront, dazu eine Kurve Tag für Tag (Anzahl und Durchschnitt pro Tag) und eine Aufschlüsselung nach Version — so lässt sich ein Einbruch dem Release zuordnen, das ihn ausgelöst hat. Standard sind die letzten 90 Tage.

Scope

reviews:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/reviews/stats?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/reviews/summary

Rezensions-KI für eine App in einem Storefront: eine Zusammenfassung der aktuellen Rezensionen und ihrer Themen — Beschwerden, Wünsche, Lob — jeweils mit den zitierten Rezensionen als Beleg. Am selben Tag und für denselben Rezensionsbestand kommt die gespeicherte Zusammenfassung ohne Verbrauch zurück; eine neue Zusammenfassung verbraucht einen Rezensions-KI-Credit aus dem Monatskontingent (in jedem Tarif; Free erhält eine Kostprobe). Antwortet mit state: "too_few" und der Anzahl, solange es zu wenige Rezensionen für eine Zusammenfassung gibt.

Scope

reviews:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

Dieser Aufruf verbraucht einen Rezensions-KI-Lauf aus dem monatlichen Kontingent, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/reviews/reply-draft

Ein Entwurf für eine Entwicklerantwort auf eine Rezension, in der Sprache des Storefronts. Bewertung und Text der Rezension stammen aus der bei uns gespeicherten Rezension, der Entwurf antwortet also auf das, was tatsächlich geschrieben wurde; note ergänzt, was die Antwort sagen soll (ein ausgelieferter Fix, eine Einstellung zum Ausprobieren). Der Entwurf wird nur zurückgegeben — reply_review sendet eine Antwort erst nach Ihrer Bestätigung. Verbraucht einen Rezensions-KI-Credit.

Scope

reviews:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country

Dieser Aufruf verbraucht einen Rezensions-KI-Lauf, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/timeline

Datierte Änderungen an der Produktseite einer App — neue Version, Screenshots, In-App-Events, Platzierungen von der Store-Seite und Änderungen am Keyword-Feld aus App Store Connect — jeweils mit der Bewegung der Keyword-Platzierungen rundherum: Begriffe, die zwischen der letzten Messung vor der Änderung und der letzten innerhalb von window Tagen danach gestiegen, gefallen, neu hinzugekommen oder herausgefallen sind, dazu die fünf größten Bewegungen.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/timeline?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/today

Der Tag einer App in einer Antwort — die Ansicht „Heute“: Käufe, Testphasen und Verlängerungen aus den verbundenen Quellen, neue Rezensionen, Ranking- und Kategoriebewegungen gegenüber gestern, Neueinsteiger vor Ihnen, neue In-App-Events und die gestrigen Zahlen zu App Store, Google Play, Erlösen und Werbung, jeweils mit ihrer Quelle gekennzeichnet. tz macht „heute“ zum eigenen Tag des Nutzers.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

curl "https://storelift.net/v1/apps/sbx-lumen/today" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/competition

Wie viele Apps in einem Storefront um jedes Keyword konkurrieren, geliefert für Begriffe, die bei zwei oder mehr Apps gesehen wurden. Standard sind die verfolgten Keywords der App; übergeben Sie terms, um Kandidaten zu zählen, bevor Sie sie verfolgen. corpus ist die Größe der Menge hinter der Zählung.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/competition?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/rivals/{rivalId}

Ein Wettbewerber Ihrer App in einem Storefront: Name, Bewertung und Anzahl der Bewertungen mit ihrem 90-Tage-Verlauf (an einer Namensänderung erkennt man eine überarbeitete Produktseite) sowie die Keywords, für die er rankt, mit seinem Platz bei jedem. Die Keyword-Liste verbraucht einen Keyword-Spy aus dem Monatskontingent und bleibt 30 Tage offen; ist das Kontingent aufgebraucht, enthält die Antwort die eigenen Zahlen des Wettbewerbers mit locked: true.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

Dieser Aufruf verbraucht eine Keyword-Spy-Abfrage aus dem monatlichen Kontingent, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/rivals/{rivalId}/adnetworks

Wie ein Wettbewerber mit Werbung Geld verdient: die Werbenetzwerke, mit denen er arbeitet, jeweils als DIRECT oder RESELLER gekennzeichnet. Der Zustand hält die Fälle auseinander — die gefundenen Netzwerke, ein Entwickler, der keine Werbenetzwerke angibt (no_file), eine Prüfung, die diesmal nicht abgeschlossen werden konnte (unreachable), oder eine Produktseite ohne Entwickler-Website (no_site). Wird 14 Tage aufbewahrt.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/adnetworks" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/rivals/{rivalId}/market

Der Markt eines Wettbewerbers in einem Storefront: bei Google Play die genaue Installationszahl und die Preisspanne der In-App-Käufe und die Installationen zwischen zwei Messungen, sobald es zwei gibt; im App Store Preis, Anzahl der Bewertungen, Veröffentlichungsdatum und ob In-App-Käufe verkauft werden. Wird auf Anfrage gemessen und 7 Tage aufbewahrt.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/market?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/storefront-audit

Ihre iOS-Produktseite in jedem App-Store-Storefront: wo die App verkauft wird, welche Storefronts statt der eigenen Sprache den Fallback-Text oder die Fallback-Screenshots zeigen und welche zweite Sprache jedes Storefront zusätzlich indexiert. Liefert den letzten Scan; refresh: true startet einen neuen, wenn der letzte älter als 12 Stunden ist, und antwortet mit 202 und eta Sekunden — danach erneut aufrufen. Die vollständige Tabelle gibt es ab Pro; Free erhält die Vorschau.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

curl "https://storelift.net/v1/apps/sbx-lumen/storefront-audit" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/suggest

Neue Keyword-Ideen für eine App in einem Storefront, geschrieben in der Suchsprache dieses Storefronts: Begriffe aus 1–3 Wörtern, die Menschen in das Suchfeld des Stores tippen, jeweils mit einer einzeiligen Begründung, wer danach sucht und warum die App diesen Bedarf erfüllt. Verfolgte Keywords, von Ihnen verworfene Keywords und Markennamen bleiben außen vor. Verbraucht einen KI-Schreib-Credit aus dem Monatskontingent (ab Pro); messen Sie die Ideen mit get_keyword_metrics, bevor Sie sie verfolgen.

Scope

apps:read

Credits

1

Plan

Pro

Nimmt außerdem: appId (erforderlich)

Dieser Aufruf verbraucht einen KI-Textlauf aus dem monatlichen Kontingent, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

POST /apps/{appId}/validate-listing

Prüft den Entwurf einer App-Store-Produktseite, bevor er an App Store Connect geht. Gemeldet werden Zeichenlimits je Feld, im Keyword-Feld durch Leerzeichen verlorener Platz, Wiederholungen, Wörter, die schon im Namen oder Untertitel stehen, Marken- und Füllwörter, Wiederholungen zwischen Name und Untertitel, Apple-Produktnamen und Preiswörter, ob der Text in der Sprache und Schrift der gewählten Sprachversion verfasst ist und welche verfolgten Keywords der App der Entwurf auslässt. Schreibt nichts; übergeben Sie nur die Felder, die geprüft werden sollen.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

curl -X POST "https://storelift.net/v1/apps/sbx-lumen/validate-listing" \
  -H "Authorization: Bearer $STORELIFT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"locale":"en-US","name":"Lumen: Sleep Sounds","subtitle":"White noise and rain for sleep","keywords":"calm,relax,nap,baby,fan,ocean,lullaby"}'

GET /apps/{appId}/draft

Ein Entwurf für die Produktseite — Titel, Untertitel, Werbetext und Beschreibung — aufgebaut aus den Keywords, die für diese App in einem Storefront gemessen wurden, nach Nachfrage geordnet. Jedes Feld kommt mit seiner Zeichenzahl gegenüber dem Store-Limit, dazu zwei Review-Prüfungen: ein Apple-Produktname in Titel oder Untertitel (nur App Store) und Preisangaben. termsUsed listet die gemessenen Begriffe dahinter, excluded die verfolgten Begriffe, die noch zu messen sind. In den Store wird nichts geschrieben — das übernimmt update_listing. Verbraucht einen KI-Schreib-Credit (ab Pro).

Scope

apps:read

Credits

1

Plan

Pro

Nimmt außerdem: appId (erforderlich) · platform

Dieser Aufruf verbraucht einen KI-Textlauf, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/localize

Schreibt die vollständige App-Store-Produktseite für eine neue Sprache — Name, Untertitel, Keyword-Feld und Beschreibung — aus der Quell-Produktseite der App; jedes Keyword wird zuerst in diesem Storefront gemessen. Der erste Aufruf startet das Schreiben und antwortet mit pending (dafür wird eine Produktseiten-Erstellung aus dem Tarif verbraucht: Free 1 insgesamt, Pro 20 und Studio 75 pro Monat); rufen Sie mit poll=true erneut auf, bis die Produktseite zurückkommt. Mit shots=true kommen auch die Screenshot-Texte in derselben Sprache zurück. Setzt voraus, dass get_storefront_audit für die App gelaufen ist. Schreibt nichts nach App Store Connect; das übernimmt update_listing.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

Dieser Aufruf verbraucht einen Schreibvorgang für Store-Einträge aus dem Plan, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/shot-text

Der Text auf Ihren ersten vier App-Store-Screenshots in einem Storefront. Apple indexiert den Text der Produktseite, dieser Text wirkt also auf die Conversion und nicht auf das Such-Ranking — die Antwort sagt das mit indexed: false. Wird aufbewahrt, bis sich die Screenshots ändern; eine neue Lesung verbraucht einen KI-Schreib-Credit (ab Pro).

Scope

apps:read

Credits

1

Plan

Pro

Nimmt außerdem: appId (erforderlich)

Dieser Aufruf verbraucht einen KI-Textlauf, zusätzlich zu seinen Credits; deshalb gibt es hier keinen Befehl zum Kopieren.

GET /apps/{appId}/chart-movers

Wer sich im Kategorie-Chart der App bewegt hat: Aufsteiger und Absteiger (3+ Plätze), Neueinsteiger und Aussteiger, mit Namen, dazu die Position der App selbst und ihrer gewählten Wettbewerber an beiden Tagen. Die Kategorie stammt aus dem Chart-Eintrag der App; übergeben Sie genre, um eine andere anzusehen. Pro-Tarif.

Scope

apps:read

Credits

1

Plan

Pro

Nimmt außerdem: appId (erforderlich) · country

curl "https://storelift.net/v1/apps/sbx-lumen/chart-movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/featuring

Wo Apple die App heute zeigt, je Land: redaktionelle Karten (dedicated: true, wenn die Story von dieser App handelt, false, wenn sie in einer Sammlung steht), laufende und geplante In-App-Events, Apples Regal You Might Also Like und der datierte Verlauf von Platzierungen und neuen Events. Lassen Sie country leer, um jedes Land zu erhalten, das die App verfolgt.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

curl "https://storelift.net/v1/apps/sbx-lumen/featuring?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}

Eine verfolgte App mit ihren Plattform-IDs, Ländern, verfolgten Keywords je Land und dem neuesten Mess-Snapshot (Keyword-Tabellen je Land). Zuerst list_apps verwenden, um die appId zu erhalten.

Scope

apps:read

Credits

1

Plan

Free

Nimmt außerdem: appId (erforderlich)

curl "https://storelift.net/v1/apps/sbx-lumen" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /apps/{appId}/weekly-plan

Die Produktseiten-Vorschläge dieser Woche für die App — dieselbe Liste wie die Karte „Diese Woche“ im Dashboard, die besten zuerst. Ein Vorschlag erscheint nur, wenn er strenge Prüfungen besteht: Ein Keyword kommt nur dann in Titel oder Untertitel, wenn es ein zentraler, stark nachgefragter Begriff der Nische der App ist, die App dafür bereits auf Platz 4–15 steht, Wettbewerber-Apps darüber es im Namen tragen und es passt, ohne die Marke oder etwas, das rankt, zu verdrängen; Nischen- oder Long-Tail-Keywords kommen höchstens ins Keyword-Feld, und nur wenn Platz ist; andere Kategorien, andere Sprachen und vom Nutzer abgelehnte Keywords erscheinen nie; solange sich eine kürzliche Änderung der Produktseite noch einpendelt, wird nichts vorgeschlagen (settling nennt den Zeitpunkt). Jede Aufgabe enthält den Satz, den aktuellen und den vorgeschlagenen Text, die Wörter, die sie hinzufügt und entfernt, die Gründe (gemessene Fakten), den Kompromiss und eine Konfidenz. Ohne country werden alle Storefronts zusammengeführt, und dieselbe Änderung ist eine Aufgabe mit ihren Ländern. Oft leer — das ist Absicht. Pro-Tarif.

Scope

apps:read

Credits

1

Plan

Pro

Nimmt außerdem: appId (erforderlich)

curl "https://storelift.net/v1/apps/sbx-lumen/weekly-plan?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"