Apple App Store App Detail
Le schede dell’Apple App Store sono pagine prodotto pubbliche con identità dell’app, testi descrittivi, contesto di sviluppatore e categoria, valutazioni visibili, prezzi e media. Questi campi supportano l’arricchimento del catalogo, il confronto tra schede e il monitoraggio dei metadati in momenti diversi.
Funzionalità della Apple App Store App Detail API
- Input in blocco da URL notiInvia uno o più URL di pagine prodotto di apps.apple.com: ogni URL ripulito corrisponde a un input del provider e per ogni URL inviato viene conservato al massimo un record di app normalizzato.
- Identità della scheda e metadati descrittiviRestituisce ID dell’app, nome, testo della descrizione, sviluppatore, categoria, URL di origine e orario di raccolta in uno schema di app coerente.
- Contesto di valutazione e prezzo visibiliConserva i campi disponibili di valutazione, numero di recensioni e prezzo strutturato, così i record delle schede si confrontano senza analizzare il testo delle pagine prodotto.
- Contesto di media e catalogoMantiene i media disponibili della scheda insieme ai timestamp di pubblicazione e di raccolta, omettendo i valori dello schema che la pagina pubblica non espone.
Parametri della Apple App Store App Detail API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio di uno o più URL noti di pagine prodotto. Ogni elemento non vuoto deve puntare a apps.apple.com o a uno dei suoi sottodomini; questo endpoint non accetta parole chiave, bundle ID né paesi. |
Come usare la Apple App Store App Detail API
Invia URL di schede note, segui l’attività asincrona e leggi i record di app normalizzati dalle pagine di risultati salvate.
- Prepara uno o più URL pubblici di pagine prodotto dell’Apple App Store il cui hostname è apps.apple.com o uno dei suoi sottodomini.
- Invia con POST l’array urls a /v1/apple-app-store/app-detail e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi i record delle app da data.results.items e segui next_cursor solo quando has_more è true.
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 trueCasi d’uso della Apple App Store App Detail API
- Arricchimento del catalogo di app: Associa identità normalizzata dell’app, metadati descrittivi, sviluppatore, categoria, prezzi, media e URL di origine ai record che contengono già link noti dell’App Store.
- Confronto tra schede: Confronta contesto di sviluppatore e categoria, valutazioni visibili, numero di recensioni, prezzi e testi descrittivi all’interno di un insieme selezionato di URL.
- Monitoraggio delle istantanee dei metadati: Salva i risultati ripetuti con collected_at per individuare nel tempo le variazioni di nomi, descrizioni, categorie, valutazioni visibili, prezzi e media.
Consigli degli esperti per la Apple App Store App Detail API
- Verifica che ogni hostname analizzato corrisponda ad apps.apple.com e invia URL di pagine prodotto, non termini di ricerca, bundle ID o nomi di store.
- Rimuovi gli URL duplicati prima dell’invio, così gli input ripetuti non creano righe del provider ridondanti né record di app duplicati.
- Tratta rating, reviews_count, price, media, published_at, installs e rank come nullable, perché una scheda può esporre solo una parte dello schema dell’app.
- Non considerare next_cursor come un token di pagina dell’App Store a monte: avanza soltanto tra i risultati già salvati per l’attività SocQ completata.
API correlate
Oltre alla Apple App Store App Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Apple App Store.
- 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.
- 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.