Apple App Store App Reviews
Bewertungen von Apps im Apple App Store sind öffentliche Kundenrückmeldungen mit Text, Sternebewertungen, Identität der Verfasser, Veröffentlichungszeit und Links zur bewerteten App. Diese Datensätze unterstützen Feedbackanalysen, den Vergleich von Sternebewertungen, die Anreicherung von App-Katalogen und die zeitbasierte Beobachtung.
Funktionen der Apple App Store App Reviews API
- Stapel bekannter App-URLsÜbergeben Sie in einer einzigen Aufgabe eine oder mehrere Produkt-URLs von apps.apple.com und legen Sie ein gemeinsames results_limit für alle aus dieser Anfrage gespeicherten Bewertungsdatensätze fest.
- Normalisierte öffentliche BewertungsdatensätzeLesen Sie Bewertungstext, numerische Sternebewertung, Identität des Verfassers, optionale Medien und stabile Datensatzfelder über das gemeinsame Bewertungsschema.
- App- und ErfassungskontextOrdnen Sie jede verfügbare Bewertung ihrer Subjekt-Kennung oder App-URL zu und behalten Sie Veröffentlichungs- und Erfassungszeitstempel für nachvollziehbare Momentaufnahmen bei.
Parameter der Apple App Store App Reviews API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste nicht leerer App-Verweise, deren geparster Hostname apps.apple.com oder eine Subdomain ist; absolute und protokollrelative Werte werden akzeptiert, im Playground durch Kommas oder Zeilenumbrüche getrennt. |
results_limit | Optional | Optionale positive ganze Zahl von 1 bis 2.000, die die Gesamtzahl der für die Aufgabe gespeicherten Bewertungsdatensätze begrenzt; der Standardwert im Backend ist 100. |
So verwenden Sie die Apple App Store App Reviews API
Senden Sie bekannte App-URLs, verfolgen Sie die asynchrone Aufgabe und blättern Sie durch die für die abgeschlossene Aufgabe gespeicherten Bewertungsdatensätze.
- Bereiten Sie mindestens einen App-Verweis vor, dessen geparster Hostname apps.apple.com ist, und wählen Sie optional ein results_limit von 1 bis 2.000.
- Senden Sie die Nutzdaten per POST an /v1/apple-app-store/app-reviews und speichern Sie die zurückgegebene task_id.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- Lesen Sie data.results.items und fahren Sie mit next_cursor fort, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Apple App Store App Reviews API
- Auswertung von App-Feedback: Nutzen Sie Bewertungstexte, Sternebewertungen und Verfasserkontext, um das öffentliche Feedback zu bekannten App-Seiten zu untersuchen.
- App-übergreifender Vergleich von Sternebewertungen: Gruppieren Sie normalisierte Datensätze nach Subjekt-Kennung oder App-URL und vergleichen Sie dann die Verteilung der Sternebewertungen über die übermittelten Produkte hinweg.
- Zeitliche Momentaufnahmen von Bewertungen: Behalten Sie Veröffentlichungs- und Erfassungszeitstempel zusammen mit den Bewertungs-IDs bei, um neu erfasste Datensätze von früheren Momentaufnahmen zu unterscheiden.
Profi-Tipps zur Apple App Store App Reviews API
- Prüfen Sie vor dem Senden jede Eingabe auf einen Hostnamen apps.apple.com; Subdomains und protokollrelative Verweise werden akzeptiert, andere Hosts abgelehnt.
- Wählen Sie results_limit für die gesamte Aufgabe und nicht pro App; ohne Angabe gelten 100, und der zulässige Bereich endet bei 2.000.
- Folgen Sie next_cursor nur, um weitere gespeicherte SocQ-Ergebnisse zu lesen; er fordert keine weitere Seite beim Anbieter an und setzt die Erfassung bei der Quelle nicht fort.
- Behandeln Sie fehlende Texte, Angaben zu Verfassern, Sternebewertungen, App-Verweise oder Medien als unbekannt und lassen Sie null-Felder in nachgelagerten Anzeigen weg.
Verwandte APIs
Ergänzend zur Apple App Store App Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Apple App Store-Daten benötigen.
- Apple App Store App Detail API — Normalisierte öffentliche App-Identität, beschreibende Metadaten, Entwickler- und Kategoriekontext, sichtbare Bewertungen, Preise und Medien aus URLs bekannter App-Store-Einträge abrufen.
- Apple App Store Rankings API — Öffentliche Kategorie-Chart-Einträge aus unterstützten Apple-App-Store-URLs erfassen – mit Quellrang, App-Identität, Entwickler, Sternebewertung, Bewertungsanzahl, Preis und Medien.