apple-app-store/
rankings

Öffentliche Kategorie-Rankings des Apple App Store aus bekannten apps.apple.com-Chart-URLs erfassen – mit Rang, App-Identität, Store-Metadaten und Medien in normalisierten Datensätzen.

Apple App Store Rankings API

Kategorie-Chart-URLs
Rang der Quelle
Normalisierte App-Datensätze
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

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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliches 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_limitOptionalOptionales 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Apple App Store-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Apple App Store Rankings API — FAQ

Apple App Store Rankings API ist eine Schnittstelle, die öffentlich platzierte Apps aus bekannten Kategorie-Chart-URLs erfasst. Sie liefert normalisierte Felder zu Rang, App-Identität, Entwickler, Kategorie, Sternebewertung, Bewertungen, Preis und Medien.

Senden Sie öffentliche Ranking-URLs, deren Hostname apps.apple.com oder eine Subdomain ist und deren Pfad /charts/ enthält. URLs einzelner Apps und andere Pfade werden von der Eingabevalidierung abgelehnt.

Jeder App-Datensatz hat das feste App-Schema mit Feldern für Rang der Quelle, Identität, öffentliche URL, Entwickler, Kategorie, Sternebewertung, Bewertungsanzahl, Preis, Text, Medien und Erfassungszeit. Optionale Werte bleiben null, wenn die Quelle sie nicht bereitstellt.

Es ist ein Gesamtlimit der Aufgabe von 1 bis 2.000 und hat ohne Angabe den Standardwert 100. Die Zahl der gespeicherten Ergebnisse kann niedriger sein, wenn Charts weniger Zeilen bereitstellen oder Datensätze dedupliziert werden.

Nein. next_cursor liest die nächste Seite der Ergebnisse, die SocQ bereits gespeichert hat; dieser Endpunkt stellt keinen Cursor des Anbieters bereit, mit dem sich die ursprüngliche Chart-Ermittlung erweitern ließe.

Jedes erfolgreich gespeicherte normalisierte App-Ergebnis kostet 0,15 SocQ-Credits. Die Schätzung der Anfrage verwendet results_limit oder 100, wenn der Wert fehlt, und vorab berechnete, nicht genutzte Credits werden bei der Abrechnung der Aufgabe erstattet.