apple-app-store/
app-detail

Öffentliche Apple-App-Store-Einträge aus bekannten apps.apple.com-URLs abrufen – mit App-Identität, Beschreibungen, Entwicklerkontext, Sternebewertungen, Preisen und Medien als normalisierte Datensätze.

Apple App Store App Detail API

Bekannte Eintrags-URLs
Normalisierte App-Datensätze
Metadaten öffentlicher Produktseiten
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 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

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

  1. Bereiten Sie eine oder mehrere öffentliche URLs von Produktseiten im Apple App Store vor, deren Hostname apps.apple.com oder eine seiner Subdomains ist.
  2. Senden Sie das Array urls per POST an /v1/apple-app-store/app-detail und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
  4. 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 true

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

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.

Weitere Plattformen entdecken

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

Apple App Store App Detail API — FAQ

Apple App Store App Detail API ist eine Schnittstelle, die öffentliche Metadaten aus bekannten Produktseiten-URLs des Apple App Store abruft. Sie liefert normalisierte App-Identität, Beschreibungen, Entwickler- und Kategoriekontext, sichtbare Sternebewertungen, Preise, Medien und die Erfassungszeit.

Senden Sie ein nicht leeres Array urls mit Produktseiten-Verweisen, deren geparster Hostname apps.apple.com oder eine seiner Subdomains ist. Dieser Endpunkt akzeptiert weder Keywords noch Bundle-IDs, Ländercodes oder ein Feld results_limit.

Ein normalisierter Datensatz kann App-ID, Name, Beschreibungstext, Entwickler, Kategorie, Sternebewertung, Bewertungsanzahl, Installationen, strukturierten Preis, Rang, Medien, Quell-URL, Veröffentlichungszeit und Erfassungszeit enthalten. Felder, die im öffentlichen Eintrag fehlen, bleiben null und sollten in der gerenderten Ansicht weggelassen werden.

Nein. Der Anbieter erhält pro übermittelter URL eine Eingabezeile, und die Aufgabe behält höchstens einen normalisierten Datensatz pro URL. next_cursor und has_more gehören ausschließlich zum gespeicherten SocQ-Ergebnisleser.

Die Schätzung der Anfrage verwendet die Anzahl der übermittelten URLs mit 0,15 Credits pro erwartetem Ergebnis. Die endgültige Abrechnung richtet sich nach der Anzahl der erfolgreich gespeicherten normalisierten Ergebnisse, und eine leere Aufgabe wird mit der Grundgebühr von null Credits abgerechnet.