Torna alle API
Dati pubblici di Twitch

Twitch Public Data API

Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.

API di Twitch disponibili

Usa Twitch Profile API per l’identità normalizzata dell’account, Twitch User Videos API per una pagina di video pubblici con i filtri supportati per tipo e ordinamento, oppure Twitch Clip Downloader API per una clip pubblica a partire dal suo URL.

Quali dati di Twitch puoi recuperare?

Il catalogo di Twitch restituisce un record normalizzato di un account pubblico oppure una pagina di video pubblici normalizzati a partire da un nome utente, o una clip pubblica a partire dal suo URL, con campi nullable quando la fonte non espone un valore.

Identità del profilo

Recupera ID dell’account, URL pubblico, nome utente, nome visualizzato e biografia, quando disponibili.

Presentazione del profilo

Conserva i campi di avatar, immagine di copertina e sito web associato, quando disponibili.

Segnali dell’account

Leggi i flag nullable di verifica e privacy senza dedurre i valori assenti.

Conteggi visibili dell’account

Mantieni i conteggi disponibili di follower, seguiti e post accanto a collected_at per confronti riferiti a un preciso momento.

Video pubblici degli utenti

Raccogli identità del video, contesto del creator, media, durata, data di pubblicazione ed engagement visibile da una pagina della fonte.

Clip pubbliche

Recupera titolo, visualizzazioni, durata, data di creazione e streamer di una clip, insieme a un link MP4 scaricabile con la relativa miniatura.

SocQ vs API di Twitch

SocQ offre il recupero di profili pubblici, video degli utenti e clip in flussi di lavoro con attività normalizzate; le API native di Twitch e la relativa autenticazione sono adatte a integrazioni applicative autorizzate e a operazioni sui canali.

FunzionalitàSocQAPI di Twitch
Uso principaleRisolvere un profilo pubblico, raccogliere una pagina di video di un utente o recuperare una clipCreare integrazioni native con Twitch basate sulle risorse di Twitch
AutenticazioneChiave API di SocQApplicazione Twitch e autorizzazione applicabile dell’utente o dell’app
Input inizialeUn nome utente, oppure un URL di clip per le clipParametri di richiesta nativi e identificatori delle risorse di Twitch
Gestione del canaleNon supportataUsa le API di Twitch autorizzate e i permessi richiesti
Formato della rispostaRecord AccountItem o ReelVideoItem normalizzati di SocQOggetti di risposta nativi di Twitch

Come funziona l’API di Twitch

Tutte le API di Twitch usano il flusso di lavoro condiviso di SocQ con attività asincrona e risultati archiviati.

  1. 1. Scegli un endpoint

    Invia con POST un nome utente pubblico valido a /v1/twitch/profile o /v1/twitch/user-videos, oppure un URL di clip a /v1/twitch/clip, e salva il task_id.

  2. 2. Segui l’attività

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

  3. 3. Leggi i record archiviati

    Usa data.results.items per i record dei profili o dei video e conserva il contesto del momento della raccolta.

Risolvi un profilo Twitch pubblico

Autenticati con una chiave API di SocQ e invia esattamente un nome utente supportato. L’attività completata con successo ha un costo fisso di 0,19 crediti.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Casi d’uso comuni dell’API di Twitch

Arricchimento dell’identità dei creator

Aggiungi ai record di creator noti identità, biografia, immagini, sito web, flag dell’account e conteggi pubblici disponibili su Twitch.

Risoluzione degli handle

Risolvi un nome utente inviato prima di associare il profilo pubblico a un’entità di ricerca interna.

Confronto tra account

Confronta profili raccolti separatamente attraverso gli stessi campi nullable di identità e metriche.

Monitoraggio con istantanee

Conserva collected_at insieme ai valori pubblici del profilo, così le esecuzioni successive restano istantanee distinguibili.

Arricchimento dell’inventario video

Associa ai canali noti identità del video pubblico, media, contesto del creator, durata, date ed engagement visibile.

Archivio dei momenti salienti

Salva l’MP4 di una clip con titolo, streamer e data di creazione per creare una raccolta consultabile dei momenti migliori di un canale.

Limiti e policy sui dati pubblici

Gli endpoint di Twitch sono ricerche di profili pubblici, video degli utenti e clip in sola lettura. Non offrono azioni autenticate sui canali né dati sui membri del pubblico.

  • Profile e User Videos accettano un solo nome utente; non accettano l’URL di un canale, un elenco di nomi utente o results_limit.
  • Twitch Clip Downloader accetta un URL di clip nel formato twitch.tv/<channel>/clip/<slug> o clips.twitch.tv/<slug>; il link MP4 restituito è firmato e scade dopo circa un giorno.
  • Il nome utente può iniziare con una @ e per il resto deve contenere da 1 a 64 lettere ASCII, numeri, punti, trattini bassi o trattini.
  • La ricerca del profilo restituisce al massimo un oggetto profilo della fonte; User Videos raccoglie una pagina della fonte e non accetta un cursore o results_limit controllati da chi chiama.
  • Identità del profilo, immagini, sito web, flag, località e singole metriche possono essere null quando i dati della fonte pubblica non sono disponibili.
  • L’endpoint non accede, non pubblica, non modera, non gestisce un canale, non recupera analytics privati e non esegue azioni sugli account autorizzate tramite OAuth.

Domande frequenti sull’API di Twitch

Che cos’è l’API di Twitch?

Le API di Twitch usano attività asincrone per risolvere un nome utente pubblico noto in un profilo normalizzato, per raccogliere una pagina dei suoi video pubblici o per recuperare una clip pubblica dal suo URL.

Quali API di Twitch sono attualmente disponibili?

Al momento sono disponibili Twitch Profile API, Twitch User Videos API e Twitch Clip Downloader API.

Posso inviare un URL di Twitch?

Twitch Clip Downloader API accetta un URL di clip in url. Twitch Profile e User Videos richiedono username e rifiutano url, urls e altri campi non dichiarati.

Questa API gestisce un canale Twitch?

No. Tutti gli endpoint di Twitch sono ricerche pubbliche in sola lettura: non autenticano un utente Twitch, non pubblicano, non moderano, non gestiscono le impostazioni del canale e non recuperano analytics privati.

Perché i campi possono essere null?

I record normalizzati di account e video conservano come null i campi pubblici facoltativi quando la fonte o il provider non espone un valore al momento della raccolta.

Quanto costano le richieste a Twitch?

Ogni attività Twitch Profile o User Videos completata con successo costa 0,19 crediti SocQ fissi. Ogni richiesta a Twitch Clip Downloader costa 0,5 crediti, e una clip non trovata viene rimborsata per intero.

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.