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à | SocQ | API di Twitch |
|---|---|---|
| Uso principale | Risolvere un profilo pubblico, raccogliere una pagina di video di un utente o recuperare una clip | Creare integrazioni native con Twitch basate sulle risorse di Twitch |
| Autenticazione | Chiave API di SocQ | Applicazione Twitch e autorizzazione applicabile dell’utente o dell’app |
| Input iniziale | Un nome utente, oppure un URL di clip per le clip | Parametri di richiesta nativi e identificatori delle risorse di Twitch |
| Gestione del canale | Non supportata | Usa le API di Twitch autorizzate e i permessi richiesti |
| Formato della risposta | Record AccountItem o ReelVideoItem normalizzati di SocQ | Oggetti 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. 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. Segui l’attività
Interroga /v1/tasks/{task_id} finché l’attività non riesce o non fallisce.
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.
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.itemsCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Rednote API
Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.
Truth Social API
Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.
Google Ad Library API
Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.
Google Maps API
Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.
Amazon API
Cerca i prodotti pubblici di Amazon e raccogli dettagli dei prodotti, Best Sellers, recensioni, profili dei venditori e vetrine dei creator normalizzati dai marketplace supportati.


