Apple App Store Rankings
Kategorie-Rankings im Apple App Store sind geordnete öffentliche App-Listen mit Rang, App-Identität, Entwickler, Kategorie, Sternebewertung, Bewertungsanzahl, Preis und Artwork-Feldern. Diese Datensätze unterstützen die Beobachtung von Charts, die Anreicherung von Katalogen mit Platzierungen und den Vergleich des öffentlichen Store-Kontexts jeder Position.
Funktionen der Apple App Store Rankings API
- Ermittlung über Kategorie-Chart-URLsVerwenden Sie eine oder mehrere öffentliche Kategorie- oder Ranking-URLs von apps.apple.com als Ausgangspunkt für die platzierten App-Datensätze, die diese Seiten bereitstellen.
- Position und App-IdentitätBehält jeden verfügbaren Rang der Quelle neben App-ID, Name und öffentlicher Store-URL bei, sodass sich die geordneten Ergebnisse eindeutig zuordnen lassen.
- Entwickler- und KategoriekontextLiefert den verfügbaren Namen des Entwicklers oder Herausgebers und die Store-Kategorie zu jedem normalisierten App-Datensatz.
- Sichtbare Store-SignaleEnthält Sternebewertung, Bewertungsanzahl und strukturierte Preiswerte, sofern das öffentliche Chart-Ergebnis sie bereitstellt.
- Beschreibungen und ArtworkBehält verfügbare App-Texte und Medienverweise im selben festen App-Schema bei, das auch für den Rest des Ergebnisses gilt.
Parameter der Apple App Store Rankings API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches Array öffentlicher Ranking-URLs des Apple App Store. Jeder geparste Hostname muss apps.apple.com oder eine seiner Subdomains sein, und jeder Pfad muss /charts/ enthalten. |
results_limit | Optional | Optionales Gesamtlimit der Aufgabe von 1 bis 2.000. Das Backend verwendet 100, wenn dieses Feld fehlt. |
So verwenden Sie die Apple App Store Rankings API
Beginnen Sie mit einer öffentlichen Kategorie-Chart-URL des Apple App Store, legen Sie das gesamte Ergebnislimit fest und lesen Sie die gespeicherten normalisierten App-Datensätze, sobald die Aufgabe erfolgreich war.
- Geben Sie eine oder mehrere öffentliche Ranking-URLs von apps.apple.com an, deren Pfad /charts/ enthält; das mitgelieferte Beispiel erfüllt die Validierungsregel des Backends.
- Legen Sie results_limit zwischen 1 und 2.000 fest oder lassen Sie es weg, um den Standardwert des Backends von 100 Ergebnissen zu verwenden.
- Senden Sie die Nutzdaten per POST an /v1/apple-app-store/rankings, speichern Sie task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
- Lesen Sie data.results.items und fordern Sie mit next_cursor die nächste gespeicherte Ergebnisseite an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/apple-app-store/rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/iphone/charts/6007"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Apple App Store Rankings API
- Beobachtung von Kategorie-Charts: Speichern Sie Rang, App-Identität und collected_at aus wiederholten Läufen, um Chart-Momentaufnahmen zu verschiedenen Zeitpunkten zu unterscheiden.
- Anreicherung von platzierten App-Katalogen: Ergänzen Sie die in einem Chart gefundenen Einträge um App-IDs, Namen, Entwickler, Kategorien, Store-URLs, Beschreibungen und Artwork.
- Vergleich des Store-Kontexts: Vergleichen Sie die verfügbaren Felder zu Rang, Sternebewertung, Bewertungsanzahl und Preis über Apps hinweg, die aus demselben Kategorie-Chart stammen.
Profi-Tipps zur Apple App Store Rankings API
- Verwenden Sie eine Ranking-URL von apps.apple.com, deren Pfad /charts/ enthält. URLs einzelner App-Details und andere Pfade bestehen die Validierung nicht, bevor die Erfassung beginnt.
- Senden Sie getrennte Aufgaben, wenn jedes Chart ein eigenes Kontingent braucht, denn results_limit begrenzt die insgesamt gespeicherten Zeilen der Aufgabe, selbst wenn urls mehrere Charts enthält.
- Folgen Sie next_cursor nur, um gespeicherte SocQ-Ergebnisse zu blättern; er fordert keine weitere Chart-Seite beim Anbieter an und erweitert das ursprüngliche Ergebnislimit nicht.
- Führen Sie sich überschneidende Charts getrennt aus, wenn jedes Vorkommen in einem Chart erhalten bleiben soll, denn eine Aufgabe dedupliziert gespeicherte Datensätze nach App-ID oder Quell-URL.
- Behandeln Sie Beschreibung, Sternebewertung, Bewertungsanzahl, Preis, Artwork und andere optionale Felder als nullable und lassen Sie leere Werte in nachgelagerten Anzeigen weg.
Verwandte APIs
Ergänzend zur Apple App Store Rankings 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 App Reviews API — Öffentliche App-Bewertungen aus bekannten apps.apple.com-URLs erfassen – mit normalisiertem Text, Sternebewertungen, Angaben zu den Bewertenden, Zeitstempeln und App-Verweisen.