Torna alle API
Dati pubblici di Apple App Store

Apple App Store APIs

Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Apple App Store da URL noti dello store, come record normalizzati di app e recensioni.

API di Apple App Store disponibili

Usa App Detail per le schede già note, Rankings per gli URL delle classifiche pubbliche e App Reviews per i commenti pubblici a partire da URL di app note.

Quali dati di Apple App Store puoi recuperare?

L’endpoint attuale mantiene i campi pubblici delle schede nello schema di risultato condiviso delle app e lascia vuoti i valori non disponibili.

Identità dell’app

Recupera ID, nomi, sviluppatori, categorie, URL di origine e testi descrittivi delle app, quando disponibili.

Segnali visibili della scheda

Conserva valutazione, numero di recensioni, prezzi, posizione in classifica e contesto di pubblicazione disponibili come valori rilevati in un dato momento.

Media e orario di osservazione

Salva i media disponibili della scheda con collected_at, così i record mantengono il contesto di osservazione.

Panoramica della specifica delle API di Apple App Store

Ogni endpoint usa URL pubblici noti e il lettore standard dei risultati delle attività asincrone.

EndpointInputAmbito della fonte
App DetailUno o più URL di pagine di prodottoAl massimo un record di app normalizzato per ogni URL inviato
RankingsURL di categorie o classifiche e results_limit facoltativoApp presenti nelle classifiche inviate
App ReviewsURL delle app e results_limit facoltativoRecensioni pubbliche delle app inviate

Come funzionano le API di Apple App Store

Tutti e tre gli endpoint usano il flusso di lavoro standard delle attività asincrone.

  1. 1. Invia gli URL delle schede note

    Scegli l’endpoint corrispondente, invia con POST l’array urls richiesto e il limite di risultati facoltativo, poi salva il task_id.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.

  3. 3. Leggi i record salvati

    Leggi data.results.items e segui next_cursor solo finché has_more è true.

Recupera i metadati pubblici delle schede delle app

Autenticati con una chiave API di SocQ e invia uno o più URL noti di pagine di prodotto di Apple App Store.

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

Casi d’uso comuni delle API di Apple App Store

Arricchimento del catalogo

Aggiungi identità normalizzata, metadati descrittivi, sviluppatore, categoria, prezzi, media e contesto di origine ai record di app già noti.

Confronto tra schede

Confronta metadati disponibili, valutazioni visibili, numero di recensioni e prezzi su un insieme preparato di URL.

Monitoraggio con istantanee

Salva i risultati ripetuti con collected_at per confrontare nel tempo i campi pubblici delle schede.

Limiti e policy sui dati pubblici

I risultati di Apple App Store sono record pubblici di schede rilevati in un dato momento e non offrono funzioni di pubblicazione o di gestione dell’account.

  • Ogni URL inviato deve puntare a apps.apple.com o a uno dei suoi sottodomini.
  • Le API accettano URL noti dello store, non parole chiave né soli bundle ID.
  • App Detail salva al massimo un risultato per URL, mentre Rankings e App Reviews accettano un results_limit valido per l’intera attività, da 1 a 2.000.
  • I cursori dei risultati delle attività scorrono solo i record già salvati da SocQ.
  • La fatturazione finale è di 0,15 crediti per risultato salvato, con base a zero crediti; la stima dipende dall’endpoint scelto.

Domande frequenti sulle API di Apple App Store

Che cosa sono le API di Apple App Store?

Le API di Apple App Store recuperano i dettagli delle app, raccolgono le classifiche per categoria e le recensioni pubbliche delle app a partire da URL noti dello store.

Posso cercare le app per parola chiave?

No. Le richieste attuali partono da array non vuoti di URL noti di prodotti o di classifiche di Apple App Store.

La fonte supporta la paginazione?

Non esiste un cursore della fonte accessibile a chi chiama. I cursori dei risultati delle attività paginano solo i record già salvati dopo la raccolta.

Come viene fatturata la raccolta?

Ogni risultato salvato costa 0,15 crediti. Gli addebiti finali usano il numero effettivo di risultati; la stima dipende dall’endpoint scelto.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.

SEO API

Interroga in tempo reale i risultati organici di Google, confronta domanda delle parole chiave e difficoltà di posizionamento, espandi i termini di partenza, scopri le parole chiave e le pagine che determinano la visibilità di un sito nelle ricerche, classifica l’intento di ricerca e raccogli i risultati di Google News, Google Images, Google Autocomplete, Bing e YouTube. Ogni endpoint usa la stessa chiave API di SocQ, lo stesso flusso di attività asincrono e lo stesso formato di risultati normalizzato.

Telegram API

Leggi i canali Telegram pubblici dai loro link t.me: profili dei canali con iscritti, post con visualizzazioni e reazioni, singoli post, commenti dei gruppi di discussione, canali simili e ricerca in tutto lo storico.

Link in Bio API

Trasforma l’unico link nella bio Instagram, TikTok o YouTube di un creator in dati strutturati: nome visualizzato, bio, avatar, email di contatto indicata, profili social collegati e ogni pulsante della pagina con titolo e destinazione.

Creator API

Parti da un profilo Instagram, TikTok, YouTube, X, Facebook o Threads per trovare le email business pubbliche di un creator, i suoi account su altre reti o una stima di età e genere dalla foto profilo.

Google Hotels API

Cerca hotel per destinazione, apri la scheda completa di qualsiasi hotel su Google Hotels e recupera il suo calendario prezzi a notte, il tutto collegato da un unico ID hotel.

Brand Monitoring API

Trova le pagine web che citano un brand, un prodotto o un tema, assegna a ciascuna un punteggio di sentiment ed emozione e riassumi come ne parla il web.