Google Play App Rankings
Eine Chart-URL von Google Play bestimmt die Kategorie oder Ranking-Oberfläche, die erfasst wird, während results_limit die Tiefe der Entdeckung von 1 bis 2000 Datensätzen steuert. Jedes gespeicherte Ergebnis folgt der Spezifikation AppItem, sodass sich der Rang zusammen mit verfügbarer Paketidentität, Entwickler, Kategorie, Bewertung, Bewertungsanzahl, Installationen, Preis, Medien, Quell-URL und Erfassungszeit analysieren lässt.
Funktionen der Google Play App Rankings API
- Stapel von Chart-URLsÜbergeben Sie ein nicht leeres Array urls mit öffentlichen play.google.com-Seiten zu Kategorien oder Rankings, statt getrennte Felder für Land oder Kategorie zu verwenden.
- Validierung von Ranking-URLs für Google PlayDie Laufzeit akzeptiert play.google.com und dessen Subdomains nur, wenn der Pfad /store/apps/collection/ oder /store/apps/category/ enthält.
- Begrenzte Erfassung von RankingsVerwenden Sie results_limit von 1 bis 2.000. Ohne Angabe gilt 100, das zugleich die Schätzung für die Abrechnung und der Standardwert der Entdeckung beim Anbieter ist.
- Normalisierte App-PositionenLiest rank zusammen mit den verfügbaren Feldern app_id, name, developer, category, rating, reviews_count, installs, price, media und öffentlichen Quellmetadaten in einer einzigen AppItem-Struktur.
- Asynchroner Datensatz-WorkflowDie übergebenen URL-Zeilen lösen einen asynchronen Datensatz beim Anbieter aus; SocQ speichert normalisierte Datensätze und gibt den Aufgabenstatus über den gemeinsamen Aufgabenleser zurück.
- Cursor für gespeicherte ErgebnisseBlättern Sie nach dem Erfolg mit dem undurchsichtigen next_cursor des Aufgabenlesers und einem limit von 1 bis 500 durch die SocQ-Datensätze. Dieser Cursor ist kein Seitentoken von Google Play oder des Anbieters.
- Abrechnung nach tatsächlichen ErgebnissenSocQ belastet vorab die angeforderte oder standardmäßige Ergebnisschätzung, rechnet dann 0,15 Credits pro gespeichertem Ergebnis ab und erstattet nicht genutzte geschätzte Credits; ein leeres Ergebnis wird mit der Grundgebühr von null Credits abgerechnet.
Parameter der Google Play App Rankings API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches, nicht leeres Array öffentlicher Ranking-URLs von Google Play. Jede URL muss play.google.com oder eine seiner Subdomains verwenden und in ihrem Pfad /store/apps/collection/ oder /store/apps/category/ enthalten; die Laufzeit akzeptiert country oder category nicht als eigenständige Felder. |
results_limit | Optional | Optionale positive ganze Zahl von 1 bis 2.000. Der Standardwert ist 100; sie begrenzt Entdeckung und gespeicherte Datensätze für die gesamte Aufgabe und liefert die anfängliche Schätzung für die Abrechnung. Eingabe-URLs werden der Reihe nach gegen das verbleibende Kontingent der Aufgabe verarbeitet. |
So verwenden Sie die Google Play App Rankings API
Senden Sie eine oder mehrere bekannte Chart-URLs von Google Play, verfolgen Sie die asynchrone Aufgabe und lesen Sie nach dem Erfolg die normalisierten Ranking-Datensätze.
- Wählen Sie öffentliche play.google.com-URLs zu Kategorien oder Rankings, deren Chart-Kontext den benötigten Markt und die gewünschte Erfassungsebene bereits festlegt.
- Senden Sie urls und optional results_limit per POST an /v1/google-play/app-rankings und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat; solange die Aufgabe in der Warteschlange steht oder läuft, sind keine Ergebnisse verfügbar.
- Lesen Sie data.results.items und fahren Sie mit next_cursor nur fort, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/google-play/app-rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/collection/topselling_free"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Continue with GET /v1/tasks/{task_id}?cursor={next_cursor}&limit=50Anwendungsfälle der Google Play App Rankings API
- Momentaufnahmen von Kategorie-Charts: Speichern Sie rank und collected_at gemeinsam, um getrennt erfasste Momentaufnahmen eines bekannten Google-Play-Charts zu vergleichen.
- Entdeckung gerankter Apps: Machen Sie aus einer kuratierten Menge von Kategorie-URLs normalisierte App-Datensätze für Prüfung, Tagging oder die nachgelagerte Anreicherung von Katalogen.
- Positionsprüfung des Portfolios: Gleichen Sie verfügbare Felder app_id und developer mit einem internen Portfolio ab und prüfen Sie dann jede zurückgegebene Position, ohne sich allein auf den Abgleich von Anzeigenamen zu verlassen.
- Store-Analyse über mehrere Läufe: Laden Sie die festen AppItem-Felder in ein Data Warehouse, damit nullable Bewertungen, Bewertungsanzahlen, Installationen, Preise und Ränge über Erfassungen hinweg vergleichbar bleiben.
Profi-Tipps zur Google Play App Rankings API
- Verwenden Sie eine öffentliche Kategorie- oder Chart-URL von Google Play, keine App-Detailseite, keinen Suchbegriff, keinen Ländercode und keine Kategoriebezeichnung; in diese Anfrage gehören nur urls und results_limit.
- Verwenden Sie eine play.google.com-URL, deren Pfad /store/apps/collection/ oder /store/apps/category/ enthält; App-Detailseiten und fremde Pfade scheitern an der Validierung, bevor die Erfassung beginnt.
- Bei mehreren Eingabe-URLs gilt results_limit für die gesamte Aufgabe. URLs werden der Reihe nach verarbeitet, und jede erhält nur das verbleibende Kontingent; teilen Sie die Aufgaben daher auf, wenn jedes Chart ein eigenes Kontingent braucht.
- Behandeln Sie App-Metadaten als nullable. Behalten Sie app_id, url, rank und collected_at bei, sofern verfügbar, statt anzunehmen, dass Bewertungen, Bewertungsanzahlen, Installationen, Preis oder Medien immer gefüllt sind.
- Senden Sie keinen Quell-Cursor. Warten Sie auf den Erfolg und nutzen Sie dann ausschließlich den undurchsichtigen next_cursor aus data.results, um die bei SocQ gespeicherten Datensätze zu blättern.
- Planen Sie das Budget zum Zeitpunkt der Übermittlung anhand von results_limit. Die endgültigen Credits richten sich nach der tatsächlichen Zahl gespeicherter Ergebnisse zu je 0,15 Credits, nicht genutzte geschätzte Credits werden erstattet.
Verwandte APIs
Ergänzend zur Google Play App Rankings API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Play-Daten benötigen.
- Google Play App Detail API — Normalisierte öffentliche Details von Google-Play-Einträgen aus bekannten App-URLs abrufen, darunter Identität, Store-Texte, Entwickler, Kategorie, sichtbare Kennzahlen, Preis, Medien und Erfassungskontext.
- Google Play App Reviews API — Öffentliche App-Bewertungen aus play.google.com-URLs erfassen – mit optionalem Länderkontext und normalisierten Feldern zu Text, Bewertendem, Sternebewertung, Zeit und App-Verweis.