apple-app-store/
app-reviews

Raccogli le recensioni pubbliche dell’Apple App Store da uno o più URL di apps.apple.com, con testo, valutazioni, dettagli sugli autori, timestamp e contesto dell’app come record normalizzati.

Apple App Store App Reviews API

URL di app note
Testo e valutazioni pubblici delle recensioni
Contesto di autore e app
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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_limitFacoltativoIntero 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.

  1. 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.
  2. Invia con POST il payload a /v1/apple-app-store/app-reviews e salva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di Apple App Store con i dati pubblici delle altre piattaforme social supportate.

Apple App Store App Reviews API — FAQ

Apple App Store App Reviews API è un’interfaccia programmatica per raccogliere le recensioni pubbliche dei clienti da URL noti di app dell’Apple App Store. Restituisce testo delle recensioni, valutazioni, dettagli sugli autori, timestamp, media e riferimenti all’app, quando disponibili, tutti normalizzati.

urls è obbligatorio e deve contenere uno o più riferimenti non vuoti il cui hostname analizzato è apps.apple.com o un sottodominio; sono accettate le forme assolute e relative al protocollo. results_limit è facoltativo, ha 100 come valore predefinito e accetta interi da 1 a 2.000.

No. results_limit limita il totale dei record salvati per l’attività su tutto l’elenco di URL inviati, quindi se servono limiti indipendenti dividi gli obiettivi di raccolta in attività separate.

No. next_cursor scorre i record già salvati da SocQ dopo il successo dell’attività; la richiesta pubblica non espone un cursore del provider per altre pagine a monte.

Ogni recensione salvata correttamente costa 0,15 crediti SocQ, con una stima di 100 risultati quando results_limit è omesso. Un’attività senza recensioni salvate non comporta alcun addebito sui risultati, perché l’addebito di base configurato è zero.