google-play/
app-reviews

Öffentliche App-Bewertungen aus Google Play anhand von play.google.com-App-URLs mit optionalem Länderkontext sammeln – mit Bewertungstext, Autoren, Sternebewertungen, Zeitstempeln und App-Verweisen als normalisierte Datensätze.

Google Play App Reviews API

Stapel von App-URLs
Bewertungstext und Sternebewertungen
Länderkontext
0,15 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Google Play App Reviews

Google-Play-App-Bewertungen sind öffentliche Beurteilungen im App-Store, die geschriebenes Feedback und Sternebewertungen mit der Identität der bewertenden Person, der Veröffentlichungszeit und dem Verweis auf die bewertete App verbinden. Diese Datensätze eignen sich für Feedback-Recherche, den Vergleich von Bewertungen, die Beobachtung von Releases und Bewertungsdatensätze mit Quelllink.

Funktionen der Google Play App Reviews API

  • Eingabe mehrerer App-URLsNimmt eine oder mehrere App-URLs auf play.google.com entgegen und verteilt die angeforderte Zahl der Bewertungen auf die übergebenen Apps.
  • Bewertungsinhalt und SternebewertungLiefert Text und numerische Sternebewertung jeder verfügbaren Bewertung in einem einheitlichen Bewertungsdatensatz.
  • Kontext zu Bewertenden und ZeitBehält verfügbare Identität der bewertenden Person, Profilverweis, Veröffentlichungszeit und Erfassungszeit zusammen mit dem Feedback bei.
  • Rückverfolgbarkeit zur bewerteten AppVerknüpft normalisierte Bewertungen über subject_id und subject_url mit verfügbaren App-Kennungen und öffentlichen App-URLs.

Parameter der Google Play App Reviews API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliches Array mit einer oder mehreren nicht leeren App-URLs auf play.google.com oder dessen Subdomains.
countryOptionalOptionale Zeichenfolge, die als Länderkontext an die Bewertungsquelle übergeben wird; lassen Sie sie weg, wenn kein Marktkontext nötig ist.
results_limitOptionalOptionale positive ganze Zahl von 1 bis 2.000. Der Standardwert ist 100; sie begrenzt die Gesamtzahl der gespeicherten Ergebnisse über alle übergebenen URLs hinweg.

So verwenden Sie die Google Play App Reviews API

Senden Sie App-URLs von Google Play, verfolgen Sie die asynchrone Aufgabe und blättern Sie durch die von SocQ gespeicherten normalisierten Datensätze.

  1. Bereiten Sie eine oder mehrere öffentliche App-URLs vor, deren Hostname play.google.com oder eine seiner Subdomains ist.
  2. Senden Sie urls mit optionalem country und results_limit per POST an /v1/google-play/app-reviews und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt; senden Sie während der Abfrage keine weitere Aufgabe.
  4. Lesen Sie nach dem Erfolg data.results.items und übergeben Sie next_cursor an die Aufgabenroute zurück, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Google Play App Reviews API

  • Recherche zu Feedback-Themen: Nutzen Sie Bewertungstext und Sternebewertungen, um ein Korpus mit Quelllink für qualitative Kodierung oder nachgelagerte Textanalyse vorzubereiten.
  • Vergleich von Sternebewertung und Text: Vergleichen Sie geschriebenes Feedback mit der zugehörigen numerischen Sternebewertung über ausgewählte öffentliche App-Seiten hinweg.
  • Beobachtung des Bewertungsverlaufs: Kombinieren Sie Veröffentlichungs- und Erfassungszeiten, um getrennt erfasste Stichproben von Bewertungen rund um Produkt-Releases zu vergleichen.
  • Anreicherung von Datensätzen mit App-Bezug: Hängen Sie Felder zu Bewertenden, Text, Sternebewertung und Zeitstempel über subject_id und subject_url an App-Datensätze an.

Profi-Tipps zur Google Play App Reviews API

  • Verwenden Sie vollständige öffentliche App-URLs auf play.google.com; andere Hosts scheitern an der Eingabevalidierung, bevor die Erfassung beginnt.
  • Wählen Sie bei mehreren URLs results_limit als Ziel für die gesamte Aufgabe, denn die Zuteilung bei der Quelle wird auf die App-Eingaben aufgeteilt und die endgültige Speicherung global begrenzt.
  • Setzen Sie country nur, wenn der Marktkontext wichtig ist, und behalten Sie denselben Wert in wiederholten Erfassungen bei, die Sie vergleichen möchten.
  • Folgen Sie dem next_cursor der Aufgabenantwort für weitere gespeicherte Datensätze; er ist ein Ergebnis-Cursor von SocQ und kein Cursor, den die Bewertungsquelle akzeptiert.
  • Behandeln Sie optionale Felder zu Bewertenden, Quelllinks und Medien als nullable, statt fehlende Werte durch erfundene Standardwerte zu ersetzen.

Ergänzend zur Google Play App Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Play-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie Google Play-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Play App Reviews API — FAQ

Google Play App Reviews API ist eine Schnittstelle zum Sammeln öffentlicher App-Bewertungen aus einer oder mehreren übergebenen Google-Play-App-URLs mit optionalem Länderkontext. Sie liefert normalisierten Bewertungstext, Angaben zu Bewertenden, Sternebewertungen, Veröffentlichungszeiten, Medien und Verweise auf die bewertete App.

urls ist ein erforderliches Array nicht leerer URLs, deren Hostname play.google.com oder eine Subdomain ist. country ist eine optionale Zeichenfolge, die an die Quellanfrage weitergegeben wird und weggelassen werden kann.

results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 1 bis 2.000. Die Quellanfrage verteilt die angeforderte Zahl auf die übergebenen URLs, während SocQ die Gesamtzahl der gespeicherten Ergebnisse der Aufgabe auf das angeforderte Limit begrenzt.

Ein normalisierter Datensatz kann Bewertungs-ID, Quell-URL, Text, Identität der bewertenden Person, numerische Sternebewertung, Veröffentlichungs- und Erfassungszeit, App-Kennung, App-URL und Medienverweise enthalten. Optionale Felder bleiben null oder leer, wenn das öffentliche Ergebnis sie nicht liefert.

Ein vom Aufrufer übergebener Quell-Cursor wird nicht akzeptiert. Nach dem Erfolg der asynchronen Aufgabe blättern next_cursor und has_more durch die bereits von SocQ gespeicherten Ergebniszeilen.

Die Aufgabe wird auf 100 Ergebnisse geschätzt, wenn results_limit fehlt, und kostet 0,15 SocQ-Credits pro gespeichertem Ergebnis. Die endgültige Abrechnung richtet sich nach der tatsächlichen Ergebniszahl, und ein erfolgreiches leeres Ergebnis wird mit der Grundgebühr von null Credits abgerechnet.