Google Play App Detail
Die App-Details bei Google Play sind öffentliche Datensätze von Store-Einträgen mit App-Identität, Beschreibungen, Entwickler- und Kategoriekontext, sichtbaren Bewertungen und Bewertungsanzahlen, Installationsbereichen, Preis und Medien. Diese Felder eignen sich für die Anreicherung von Katalogen, den Vergleich ausgewählter Apps und die Beobachtung zu bestimmten Zeitpunkten.
Funktionen der Google Play App Detail API
- Stapelgrenze bekannter URLsÜbergeben Sie eine oder mehrere App-URLs auf play.google.com für die direkte Detailabfrage, ohne die Anfrage in eine Keyword-Suche zu verwandeln.
- Identität und Text des EintragsNormalisiert Paketkennung, App-Namen, öffentliche Store-Beschreibung, Entwickler, Kategorie, Quell-URL und Erfassungszeit.
- Sichtbarer MarktkontextBehält verfügbare Felder zu Bewertung, Bewertungsanzahl, Installationsbereich, Preis und Rang als nullable Beobachtungen aus dem öffentlichen Eintrag bei.
- App-Datensätze mit MedienLiefert Medien zusammen mit einem stabilen App-Schema, sodass Eintragsdatensätze denselben asynchronen Ergebnis-Workflow durchlaufen wie andere SocQ-Daten.
Parameter der Google Play App Detail API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches, nicht leeres Zeichenfolgen-Array bekannter App-URLs, deren geparster Hostname play.google.com oder eine Subdomain davon ist. Jede akzeptierte URL ist eine Detailabfrage. |
So verwenden Sie die Google Play App Detail API
Senden Sie bekannte Google-Play-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie nach dem Abschluss die normalisierten App-Datensätze.
- Bereiten Sie ein nicht leeres Array urls mit App-Links vor, deren geparster Hostname play.google.com oder eine unterstützte Subdomain ist.
- Senden Sie das Array per POST an /v1/google-play/app-detail und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- Lesen Sie nach dem Erfolg data.results.items. Folgen Sie next_cursor nur, wenn has_more den Wert true hat; er blättert durch bereits von SocQ gespeicherte Datensätze und entdeckt keine weitere Quellseite von Google Play.
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.itemsAnwendungsfälle der Google Play App Detail API
- Einen bekannten App-Katalog anreichern: Verwandeln Sie gespeicherte Google-Play-Links in normalisierte Paket-IDs, Titel, Beschreibungen, Entwickler, Kategorien, Quell-URLs und Erfassungszeitstempel.
- Ausgewählte Einträge vergleichen: Gleichen Sie verfügbare Felder zu Bewertung, Bewertungsanzahl, Installationsbereich, Preis, Kategorie und Medien über eine freigegebene Menge von App-URLs ab.
- Momentaufnahmen von Einträgen beobachten: Wiederholen Sie die Abfragen nach einem festgelegten Zeitplan und vergleichen Sie nullable Eintragsfelder mit collected_at, um Änderungen zu bestimmten Zeitpunkten zu erkennen.
Profi-Tipps zur Google Play App Detail API
- Verwenden Sie vollständige Google-Play-App-URLs und entfernen Sie vor dem Senden Duplikate aus dem Array, damit die Schätzung die beabsichtigten Abfragen widerspiegelt.
- Betrachten Sie jede Eingabe-URL als berechtigt für höchstens ein Ergebnis und ordnen Sie zurückgegebene Datensätze über url oder app_id zu, denn eine akzeptierte URL kann dennoch ohne Element bleiben.
- Speichern Sie Bewertung, Bewertungsanzahl, Installationsbereich, Preis, Rang und Medien defensiv, da öffentliche Eintragsfelder fehlen oder sich nach der Erfassung ändern können.
- Nutzen Sie next_cursor nur, um die gespeicherten SocQ-Ergebnisse einer abgeschlossenen Aufgabe weiterzulesen; dieser Detail-Endpunkt bietet weder Google-Play-Suche noch Paginierung von Quellseiten.
Verwandte APIs
Ergänzend zur Google Play App Detail API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Play-Daten benötigen.
- Google Play App Rankings API
- 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.