Hive-Endpunkte

GET /rank-check

Der Live-Platz einer Ihrer Apps für einen beliebigen Suchbegriff in einem Storefront, so, wie der Store es in diesem Moment zeigt — der Begriff muss nicht verfolgt werden. Der Zustand hält die Fälle auseinander: ranked mit dem Platz und den Apps direkt darüber, absent mit den obersten Ergebnissen (die App wird dort verkauft und liegt außerhalb dieser Ergebnisse), not_in_store (die App wird in diesem Storefront nicht verkauft).

Scope

apps:read

Credits

10

Plan

Free

curl "https://storelift.net/v1/rank-check?app=us&term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /keyword-difficulty

Eingangswerte für Nachfrage und Schwierigkeit eines App-Store-Suchbegriffs in einem Storefront: seine Nachfrage (demand) und die verwandten Suchen, die obersten Ergebnisse mit der Anzahl ihrer Bewertungen und ob der Begriff in ihrem Titel steht, die höchste Bewertungsanzahl unter ihnen und ihr Median und wie tief die Ergebnisse reichen. thin kennzeichnet einen Begriff mit weniger als zehn Ergebnissen; zayifEslesme kennzeichnet einen Begriff, den der Store nur lose zuordnet. Free liest die Begriffe, die das Konto in diesem Storefront verfolgt; ab Pro wird jeder Begriff gelesen.

Scope

apps:read

Credits

10

Plan

Free

curl "https://storelift.net/v1/keyword-difficulty?term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/find

Findet Apps in den Top-Charts, die wir messen: Filter nach Kategorie, Storefront, Chart (Top Grossing, Top Free, Top Paid oder Top iPad), Platzbereich, Datum der ersten Sichtung, Name oder Anbieter sowie nach Monatsumsatz, monatlichen Downloads oder 30-Tage-Wachstum. Übergeben Sie estimates: true, um zu jeder Zeile Monatsumsatz und Downloads aus Hive zu erhalten, je eine Zahl, mit dem Tag der Zahl. Ist ein Umsatz-, Download- oder Wachstumsfilter gesetzt, bleiben Apps, zu denen Hive noch keine Zahl hat, außen vor und werden in noEstimate gezählt. 20 Credits für die Liste; mit Zahlen oder mit einem Umsatz-, Download- oder Wachstumsfilter 50 weitere pro gelieferter Zeile. Die Antwort enthält coverage, den Tag, an dem der Index der ersten Sichtungen beginnt — jedes Datum, das Sie lesen, ist also ein Tag, den wir indexiert haben.

Scope

hive:read

Credits

20

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/find?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/charts

Ein Top-Chart, wie wir es zuletzt gemessen haben: die App-IDs in Rangfolge für ein Storefront, eine Listenart und eine optionale Kategorie, mit dem Tag der Lesung. Übergeben Sie estimates: true für den Monatswert jedes Platzes (Umsatz bei Top Grossing, Downloads bei Top Free) und dafür, was für den Einstieg auf Platz 10, 50 und 100 nötig ist. 10 Credits für die Liste; mit estimates 50 weitere pro gelieferter Zeile. Nur App Store — Google Play hat keine öffentliche Top-Liste, und eine Zahl dort wäre erfunden.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

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

In der Sandbox öffnen

GET /hive/movers

Wer in einem Top-Chart gestiegen, gefallen, eingestiegen und ausgestiegen ist, verglichen mit demselben Chart vor N Tagen. measured sagt Ihnen, dass der Vergleichstag vorliegt — jede Differenz, die Sie lesen, liegt also zwischen zwei gemessenen Tagen; ausgestiegene Apps tragen ihren letzten Platz statt einer Differenz, da sie heute außerhalb des Charts liegen.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

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

GET /hive/new

Apps, die erstmals in einem Top-Chart gesehen wurden, das Neueste zuerst, jeweils mit dem Anbieter dahinter. daysCovered sagt, wie viele der angefragten Tage der Index enthält — jedes Datum einer ersten Sichtung, das Sie lesen, ist also ein Tag, den wir indexiert haben.

Scope

hive:read

Credits

10

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/new?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/publisher/{publisherId}

Jede App eines Anbieters, die wir in einem Chart gesehen haben, mit dem Tag der ersten Sichtung. Apps des Anbieters, die nie in einem Chart standen, fehlen hier — wir listen, was wir gemessen haben, nicht, was existiert.

Scope

hive:read

Credits

10

Plan

Hive Explorer

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

GET /hive/resolve

Findet die ID einer beliebigen App: über Name oder Entwickler (die besten Treffer in diesem Storefront, mit Anbieter, Kategorie, Bewertung und Anzahl der Bewertungen) oder aus einem App-Store-/Google-Play-Link, einer bloßen App-Store-ID oder einem Paketnamen. Verwenden Sie es vor hive_app_details, hive_similar_apps oder hive_app_reviews, wenn Sie nur einen Namen haben.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/resolve?q=sleep&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/similar/{appId}

Das eigene Regal des Stores mit ähnlichen Apps für eine beliebige App (Apples You Might Also Like, Googles Similar apps), in Regalreihenfolge, mit Kategorie, Name und Anbieter jeder App und dem Tag, an dem das Regal gelesen wurde. Die Kategorien im Regal zeigen, in welches Umfeld der Store die App einordnet.

Scope

hive:read

Credits

10

Plan

Hive Explorer

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

GET /hive/reviews/{appId}

Die aktuellen Rezensionen einer beliebigen App in einem Storefront, das Neueste zuerst: Sterne, Titel, Text, Version und Datum, dazu die Sterneverteilung der gelieferten Zeilen. Namen der Rezensenten werden weggelassen. Eine App, die Hive noch nicht führt, wird beim ersten Aufruf aufgenommen.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

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

POST /hive/keywords/{term}/metrics/measure

Startet eine Messung der Popularität und/oder Schwierigkeit eines Keywords in einem Storefront, wenn der gespeicherte Wert fehlt oder veraltet ist. Ein frischer Wert oder ein verifiziertes Fehlen wird ohne neue Arbeit geliefert; eine Anfrage, die sich einem bereits laufenden Job anschließt, verbraucht keine tägliche Messeinheit; die Anfrage, die neue Arbeit startet, verbraucht eine aus dem täglichen Hive-Messkontingent des Workspace. Die beiden Metriken sind unabhängig: Fällt eine Quelle aus, bleibt die andere gültige Metrik in der Antwort. wait (0–20 Sekunden) hält den Aufruf offen, bis das Ergebnis gespeichert ist; 202 heißt, er läuft noch — später mit hive_keyword_metrics lesen. Benötigt den Opt-in-Bereich hive:measure: am API-Schlüssel gewählt oder beim Verbinden über OAuth gesondert freigegeben. Nur iOS.

Scope

hive:measure

Credits

50

Plan

Hive Explorer

Ein neuer Auftrag verbraucht eine Messung aus dem täglichen Hive-Messkontingent des Workspace, deshalb gibt es hier keinen Befehl zum Kopieren.

Anfrage-Body

{"country":"us","platform":"ios","metrics":["popularity","difficulty"],"wait":15}

GET /hive/apps/{id}

Store-Details, die das Netzwerk für eine beliebige App an ihrem neuesten Tag gemessen hat: Name, Anzahl der Bewertungen, Bewertung, Version, Preis, Verteilung, Abzeichen und Zahl der In-App-Käufe. Bei App-Store-Apps ergänzt listingExtras die unterstützten Sprachen, die Sterneverteilung (1★ bis 5★), laufende und kommende In-App-Events, den Werbetext und die hervorgehobenen In-App-Käufe, mit eigenem measuredAt; ohne Messung ist es null. not_measured nennt die Storefronts, in denen die App hinzugefügt werden sollte.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

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

In der Sandbox öffnen

GET /hive/keywords/{term}/ranks

Die obersten Ergebnisse für jedes Keyword, das das Netzwerk misst, je Tag. days schrumpft, wenn top groß ist, damit ein Aufruf unter 1.000 Zeilen bleibt. 10 Credits für bis zu 7 Tage, 20 für bis zu 30, 40 für bis zu 90.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country · platform

curl "https://storelift.net/v1/hive/keywords/sleep/ranks?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /hive/keywords/{term}/metrics

Liest vorhandene Hive-Beobachtungen für ein exaktes Keyword und Storefront. Die Popularität ist eine ganze Zahl von 1 bis 100; die Schwierigkeit ist ein Wert von 0 bis 100. Fehlende Daten bleiben null. Jede Metrik trägt ihren eigenen Beleg, Quellzeitpunkt, ihre Aktualität und den Status des letzten Versuchs. Dieses GET startet nie eine Quellanfrage oder einen Messjob. Erfordert das vollständige Produkt Hive Explorer; Android wird ausdrücklich nicht unterstützt.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /hive/keywords/{term}/metrics/history

Liest den gespeicherten Tagesverlauf eines Keywords: die Suchergebnisse, den Schwierigkeitswert und die Apple-Popularität, die an jedem Tag erfasst wurden. Frühere Schwierigkeitswerte bleiben so, wie sie erfasst wurden. Fehlgeschlagene und unvollständige Tage sind als solche markiert; ein Tag ohne gespeicherten Eintrag ist weder null noch ein verifiziertes Fehlen. Folgen Sie pagination.nextCursor mit denselben Werten für keyword, storefront und days. Jede Reihe wird einzeln paginiert, mit bis zu 200 Einträgen pro Seite. Dieses GET liest nur den gespeicherten Verlauf und startet nie eine Messung. Erfordert das vollständige Produkt Hive Explorer; Android wird ausdrücklich nicht unterstützt. 10 Credits für bis zu 7 Tage, 20 für bis zu 30, 40 für bis zu 90.

Scope

hive:read

Credits

20

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /hive/spy/{id}

Jedes Keyword, zu dem das Netzwerk eine App gemessen hat, mit ihrem Platz. Jeder Aufruf wird in Credits bezahlt; eine App ohne anzuzeigende Keywords kostet 1.

Scope

hive:spy

Credits

200

Plan

Hive Explorer

Nimmt außerdem: country · platform

curl "https://storelift.net/v1/hive/spy/1000000104?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /hive/estimate/{id}

Monatsumsatz und Downloads für jede App-Store-App, weltweit: je eine Zahl (value oder under, wenn die App unter diesem Betrag liegt) und wie viele Märkte sie abdeckt. Jede App erhält eine Antwort. Hive kennt sie bereits. Die erste Anfrage zu einer App startet die Lesung und antwortet mit 202 und eta Sekunden. 500 Credits für die Zahlen; eine ausstehende Antwort kostet 1.

Scope

hive:estimate

Credits

500

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/estimate/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

In der Sandbox öffnen

GET /hive/gap

Die Keyword-Listen von bis zu 5 Apps nebeneinander, eine Zeile pro Keyword: der Platz jeder App, wie viele es halten und welchen es fehlt. 200 Credits pro verglichener App; eine App außerhalb des Index wird nicht berechnet. Teil von Explorer.

Scope

hive:spy

Credits

400

Plan

Hive Explorer

Nimmt außerdem: country · platform

curl "https://storelift.net/v1/hive/gap?ids=1000000001,1000000104&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/research

Geben Sie ein Seed-Keyword ein und erhalten Sie verwandte Suchbegriffe aus dem App Store, jeweils mit Apple-Popularität (1–100, wenn beobachtet; fehlende Werte bleiben null), Schwierigkeit (0–100), der Zahl der Apps, die dafür ranken, und den Top-10-Apps. Der Beleg einer Metrik unterscheidet einen gemessenen Wert, ein verifiziertes Fehlen, ausstehende Arbeit und Quellfehler. Zeilen mit laufender Messung tragen state: "pending"; wiederholen Sie die Anfrage, um das Ergebnis zu lesen. Korrigiert der App Store die Schreibweise eines Begriffs, enthält die Zeile in spell die korrigierte Suche. Keine App nötig. Teil von Explorer.

Scope

hive:read

Credits

50

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/research?seed=us&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/landscape

Die Kategorielandschaft eines Storefronts aus seiner Top-Gratis-Liste: die Bewertungswand der Top 10, Median der Bewertung, Namenslänge, Aktualität von Veröffentlichung und Update, Sprachen, Größe und Anbieter mit mehreren Apps. Jede Kategorie trägt ihren eigenen Messtag.

Scope

hive:read

Credits

10

Plan

Hive Explorer

Nimmt außerdem: country

curl "https://storelift.net/v1/hive/landscape?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"