Apple App Store App Reviews
Le recensioni delle app dell’Apple App Store sono record pubblici di feedback dei clienti, con testo scritto, valutazioni, identità dell’autore, orario di pubblicazione e link all’app recensita. Questi record supportano l’analisi del feedback, il confronto delle valutazioni, l’arricchimento del catalogo di app e il monitoraggio nel tempo.
Funzionalità della Apple App Store App Reviews API
- Lotti di URL di app noteInvia uno o più URL di prodotto di apps.apple.com in un’unica attività e imposta un solo results_limit per il totale dei record di recensione salvati da quella richiesta.
- Record pubblici di recensione normalizzatiLeggi testo della recensione, valutazione numerica, identità dell’autore, eventuali media e campi stabili del record attraverso lo schema condiviso delle recensioni.
- Contesto di app e raccoltaAssocia ogni recensione disponibile al relativo identificativo del soggetto o all’URL dell’app, conservando i timestamp di pubblicazione e di raccolta per istantanee tracciabili.
Parametri della Apple App Store App Reviews API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di riferimenti non vuoti ad app il cui hostname analizzato è apps.apple.com o un sottodominio; sono accettati valori assoluti e relativi al protocollo, separati da virgole o da a capo nel Playground. |
results_limit | Facoltativo | Intero positivo facoltativo da 1 a 2.000 che limita il totale dei record di recensione salvati per l’attività; il valore predefinito del backend è 100. |
Come usare la Apple App Store App Reviews API
Invia URL di app note, segui l’attività asincrona e scorri i record di recensione salvati per l’attività completata.
- Prepara almeno un riferimento a un’app il cui hostname analizzato è apps.apple.com e, se vuoi, scegli un results_limit da 1 a 2.000.
- Invia con POST il payload a /v1/apple-app-store/app-reviews e salva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- Leggi data.results.items e continua con next_cursor finché has_more è true.
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 trueCasi d’uso della Apple App Store App Reviews API
- Analisi del feedback sulle app: Usa il testo scritto delle recensioni, i valori di valutazione e il contesto degli autori per esaminare il feedback pubblico restituito per le pagine di app note.
- Confronto delle valutazioni tra app: Raggruppa i record normalizzati per identificativo del soggetto o URL dell’app, poi confronta le distribuzioni delle valutazioni tra i prodotti inviati.
- Istantanee della cronologia delle recensioni: Conserva i timestamp di pubblicazione e di raccolta insieme agli ID delle recensioni per distinguere i record raccolti di recente dalle istantanee precedenti.
Consigli degli esperti per la Apple App Store App Reviews API
- Verifica che ogni input abbia un hostname apps.apple.com prima dell’invio; sottodomini e riferimenti relativi al protocollo sono accettati, mentre gli altri host vengono rifiutati.
- Scegli results_limit per l’attività nel suo complesso e non per singola app; le richieste che lo omettono usano 100 e l’intervallo accettato arriva fino a 2.000.
- Usa next_cursor solo per leggere altri risultati già salvati da SocQ; non richiede un’altra pagina al provider né prosegue la raccolta a monte.
- Tratta testo, dettagli dell’autore, valutazione, riferimenti all’app o media mancanti come sconosciuti e ometti i campi null nelle visualizzazioni a valle.
API correlate
Oltre alla Apple App Store App Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Apple App Store.
- Apple App Store App Detail API — Recupera identità pubblica dell’app, metadati descrittivi, contesto di sviluppatore e categoria, valutazioni visibili, prezzi e media normalizzati dagli URL delle schede dell’App Store noti.
- Apple App Store Rankings API — Raccoglie le voci delle classifiche per categoria dagli URL supportati dell’Apple App Store con posizione di origine, identità dell’app, sviluppatore, valutazione, numero di recensioni, prezzo e media.