apple-app-store/
rankings

Raccogli le classifiche pubbliche per categoria dell’Apple App Store da URL noti di classifiche su apps.apple.com, con posizione, identità dell’app, metadati dello store e media in record normalizzati.

Apple App Store Rankings API

URL delle classifiche per categoria
Posizione di origine
Record di app normalizzati
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioArray 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_limitFacoltativoLimite 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.

  1. 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.
  2. Imposta results_limit da 1 a 2.000, oppure omettilo per usare il valore predefinito del backend di 100 risultati.
  3. 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.
  4. 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 true

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

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.

Esplora altre piattaforme

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

Apple App Store Rankings API — FAQ

Apple App Store Rankings API è un’interfaccia programmatica per raccogliere le applicazioni pubbliche in classifica da URL noti di classifiche per categoria. Restituisce posizione, identità dell’app, sviluppatore, categoria, valutazione, recensioni, prezzo e campi media, tutti normalizzati.

Invia URL pubblici di classifiche il cui hostname è apps.apple.com o un sottodominio e il cui percorso contiene /charts/. Gli URL di singole app e i percorsi non pertinenti vengono rifiutati dalla validazione dell’input.

Ogni record di app ha lo schema di app fisso, con i campi di posizione di origine, identità, URL pubblico, sviluppatore, categoria, valutazione, numero di recensioni, prezzo, testo, media e orario di raccolta. I valori facoltativi restano null quando la fonte non li espone.

È un limite complessivo dell’attività da 1 a 2.000 e, se omesso, vale 100. Il numero di risultati salvati può essere inferiore quando le classifiche espongono meno righe o i record vengono deduplicati.

No. next_cursor legge la pagina successiva dei risultati già salvati da SocQ; questo endpoint non espone un cursore del provider per estendere l’esecuzione originale di individuazione della classifica.

Ogni risultato di app normalizzato salvato correttamente costa 0,15 crediti SocQ. La stima della richiesta usa results_limit oppure 100 se omesso, e i crediti prepagati non usati vengono rimborsati quando l’attività si chiude.