Apple App Store Rankings
Le classifiche per categoria dell’Apple App Store sono elenchi pubblici ordinati di app, con posizione, identità dell’app, sviluppatore, categoria, valutazione, numero di recensioni, prezzo e campi di artwork. Questi record supportano il monitoraggio delle classifiche, l’arricchimento di cataloghi ordinati e il confronto del contesto pubblico dello store associato a ogni posizione.
Funzionalità della Apple App Store Rankings API
- Individuazione da URL di classifiche per categoriaUsa uno o più URL pubblici di categorie o classifiche di apps.apple.com come input per individuare i record di app in classifica esposti da quelle pagine.
- Posizione e identità dell’appMantiene ogni posizione di origine disponibile accanto a ID, nome e URL pubblico dello store dell’app, così i risultati ordinati restano identificabili.
- Contesto di sviluppatore e categoriaRestituisce il nome disponibile dello sviluppatore o dell’editore e la categoria dello store con ogni record di applicazione normalizzato.
- Segnali visibili dello storeInclude valutazione, numero di recensioni e valori di prezzo strutturati quando il risultato pubblico della classifica li espone.
- Descrizioni e artworkConserva i testi dell’app e i riferimenti ai media disponibili nello stesso schema di app fisso usato per il resto del risultato.
Parametri della Apple App Store Rankings API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio di URL pubblici di classifiche dell’Apple App Store. Ogni hostname analizzato deve essere apps.apple.com o uno dei suoi sottodomini e ogni percorso deve contenere /charts/. |
results_limit | Facoltativo | Limite complessivo facoltativo dell’attività da 1 a 2.000. Il backend usa 100 quando questo campo è omesso. |
Come usare la Apple App Store Rankings API
Parti da un URL pubblico di una classifica per categoria dell’Apple App Store, imposta il limite complessivo dei risultati e leggi i record di app normalizzati salvati quando l’attività riesce.
- Inserisci uno o più URL pubblici di classifiche di apps.apple.com il cui percorso contiene /charts/; l’esempio fornito soddisfa la regola di validazione del backend.
- Imposta results_limit da 1 a 2.000, oppure omettilo per usare il valore predefinito del backend di 100 risultati.
- Invia con POST il payload a /v1/apple-app-store/rankings, salva il task_id e interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Leggi data.results.items e richiedi la pagina successiva dei risultati salvati con next_cursor finché has_more è true.
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 trueCasi d’uso della Apple App Store Rankings API
- Monitoraggio delle classifiche per categoria: Salva posizione, identità dell’app e collected_at da esecuzioni ripetute per distinguere le istantanee delle classifiche in momenti diversi.
- Arricchimento del catalogo di app in classifica: Associa ID, nomi, sviluppatori, categorie, URL dello store, descrizioni e artwork delle app alle voci individuate in una classifica.
- Confronto del contesto dello store: Confronta posizione, valutazione, numero di recensioni e prezzo disponibili tra le app restituite dalla stessa classifica per categoria.
Consigli degli esperti per la Apple App Store Rankings API
- Usa un URL di classifica di apps.apple.com il cui percorso contiene /charts/. Gli URL di dettaglio di singole app e i percorsi non pertinenti non superano la validazione prima dell’avvio della raccolta.
- Invia attività separate quando ogni classifica richiede una propria quota, perché results_limit limita il totale delle righe salvate per l’attività anche quando urls contiene più classifiche.
- Usa next_cursor solo per scorrere i risultati SocQ già salvati; non richiede un’altra pagina di classifica al provider né estende il limite originale dei risultati.
- Esegui separatamente le classifiche che si sovrappongono quando serve conservare ogni occorrenza in classifica, perché un’attività deduplica i record salvati per ID dell’app o URL di origine.
- Tratta descrizione, valutazione, numero di recensioni, prezzo, artwork e altri campi facoltativi come nullable e ometti i valori vuoti nelle visualizzazioni a valle.
API correlate
Oltre alla Apple App Store Rankings 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 App Reviews API — Raccoglie le recensioni pubbliche delle app dagli URL apps.apple.com noti con testo, valutazioni, dettagli di chi recensisce, date e riferimenti all’app normalizzati.