apple-app-store/
app-detail

Recupera le schede pubbliche dell’Apple App Store da URL noti di apps.apple.com, con identità dell’app, descrizioni, contesto dello sviluppatore, valutazioni, prezzi e media come record normalizzati.

Apple App Store App Detail API

URL di schede note
Record di app normalizzati
Metadati delle pagine prodotto pubbliche
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 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

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

  1. Prepara uno o più URL pubblici di pagine prodotto dell’Apple App Store il cui hostname è apps.apple.com o uno dei suoi sottodomini.
  2. Invia con POST l’array urls a /v1/apple-app-store/app-detail e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. 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 true

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

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.

Esplora altre piattaforme

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

Apple App Store App Detail API — FAQ

Apple App Store App Detail API è un’interfaccia programmatica per recuperare i metadati pubblici da URL noti di pagine prodotto dell’Apple App Store. Restituisce identità dell’app, descrizioni, contesto di sviluppatore e categoria, valutazioni visibili, prezzi, media e orario di raccolta, tutti normalizzati.

Invia un array urls non vuoto con riferimenti a pagine prodotto il cui hostname analizzato è apps.apple.com o uno dei suoi sottodomini. Questo endpoint non accetta parole chiave, bundle ID, codici paese né un campo results_limit.

Un record normalizzato può includere ID dell’app, nome, testo della descrizione, sviluppatore, categoria, valutazione, numero di recensioni, installazioni, prezzo strutturato, posizione, media, URL di origine, orario di pubblicazione e orario di raccolta. I campi assenti dalla scheda pubblica restano null e vanno omessi nella vista visualizzata.

No. Il provider riceve una riga di input per ogni URL inviato e l’attività conserva al massimo un record normalizzato per URL. next_cursor e has_more appartengono solo al lettore dei risultati salvati di SocQ.

La stima della richiesta usa il numero di URL inviati a 0,15 crediti per ogni risultato atteso. La fatturazione finale usa il numero di risultati normalizzati salvati correttamente e un’attività vuota si chiude con l’addebito di base a zero crediti.