Apple App Store App Detail
Einträge im Apple App Store sind öffentliche Produktseiten mit App-Identität, beschreibenden Texten, Entwickler- und Kategoriekontext, sichtbaren Sternebewertungen, Preisen und Medien. Diese Felder unterstützen Kataloganreicherung, Eintragsvergleiche und die Beobachtung von Metadaten zu bestimmten Stichtagen.
Funktionen der Apple App Store App Detail API
- Stapeleingabe bekannter URLsÜbergeben Sie eine oder mehrere Produktseiten-URLs von apps.apple.com; jede bereinigte URL wird einer Anbieter-Eingabe zugeordnet, und pro übermittelter URL bleibt höchstens ein normalisierter App-Datensatz erhalten.
- Eintragsidentität und beschreibende MetadatenLiefert App-ID, Name, Beschreibungstext, Entwickler, Kategorie, Quell-URL und Erfassungszeit in einem einheitlichen App-Schema.
- Sichtbarer Kontext zu Bewertung und PreisBehält die verfügbaren Felder zu Sternebewertung, Bewertungsanzahl und strukturiertem Preis bei, damit sich Eintragsdatensätze vergleichen lassen, ohne den Text der Produktseite auszuwerten.
- Medien und KatalogkontextBehält verfügbare Medien des Eintrags neben Veröffentlichungs- und Erfassungszeitstempeln bei und lässt Schemawerte weg, die die öffentliche Seite nicht preisgibt.
Parameter der Apple App Store App Detail API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches Array mit einer oder mehreren bekannten Produktseiten-URLs. Jeder nicht leere Eintrag muss auf apps.apple.com oder eine seiner Subdomains verweisen; Keywords, Bundle-IDs und Ländereingaben akzeptiert dieser Endpunkt nicht. |
So verwenden Sie die Apple App Store App Detail API
Senden Sie bekannte Eintrags-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten App-Datensätze aus den gespeicherten Ergebnisseiten.
- Bereiten Sie eine oder mehrere öffentliche URLs von Produktseiten im Apple App Store vor, deren Hostname apps.apple.com oder eine seiner Subdomains ist.
- Senden Sie das Array urls per POST an /v1/apple-app-store/app-detail und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
- Lesen Sie die App-Datensätze aus data.results.items und folgen Sie next_cursor nur, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
-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 only while has_more is trueAnwendungsfälle der Apple App Store App Detail API
- Anreicherung von App-Katalogen: Ergänzen Sie Datensätze, die bereits bekannte App-Store-Links enthalten, um normalisierte App-Identität, beschreibende Metadaten, Entwickler, Kategorie, Preise, Medien und Quell-URLs.
- Vergleich von Einträgen: Vergleichen Sie Entwickler- und Kategoriekontext, sichtbare Sternebewertungen, Bewertungsanzahlen, Preise und Beschreibungstexte über eine ausgewählte URL-Menge hinweg.
- Beobachtung von Metadaten-Momentaufnahmen: Speichern Sie wiederholte Ergebnisse mit collected_at, um Änderungen bei Namen, Beschreibungen, Kategorien, sichtbaren Sternebewertungen, Preisen und Medien im Zeitverlauf zu erkennen.
Profi-Tipps zur Apple App Store App Detail API
- Prüfen Sie jeden geparsten Hostnamen gegen apps.apple.com und senden Sie Produktseiten-URLs statt Suchbegriffen, Bundle-IDs oder Store-Namen.
- Entfernen Sie doppelte URLs vor dem Senden, damit wiederholte Eingaben keine überflüssigen Anbieterzeilen oder doppelten App-Datensätze erzeugen.
- Behandeln Sie rating, reviews_count, price, media, published_at, installs und rank als nullable, denn ein Eintrag stellt womöglich nur einen Teil des App-Schemas bereit.
- Verstehen Sie next_cursor nicht als Seitentoken des App Store; er blättert nur durch Ergebnisse, die für die abgeschlossene SocQ-Aufgabe bereits gespeichert sind.
Verwandte APIs
Ergänzend zur Apple App Store App Detail API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Apple App Store-Daten benötigen.
- 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.
- 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.