Twitch User Videos
I video di Twitch User Videos sono archivi, momenti salienti e caricamenti pubblici di un canale, con descrizioni, contesto del creator, riferimenti ai media, durata, ora di pubblicazione ed engagement visibile. Questi record supportano la catalogazione dei canali, il confronto tra formati, la ricerca sulla pubblicazione e i report puntuali sulle prestazioni.
Funzionalità della Twitch User Videos API
- Inventario per nome utenteTrasforma un nome utente pubblico di Twitch nei record video restituiti per quel canale in una singola richiesta alla fonte.
- Filtri per archivi, momenti salienti e caricamentiSeleziona tutti i video oppure restringi la richiesta alla fonte con i valori accettati archive, highlight o upload e i loro alias al plurale.
- Ordinamento per tempo o visualizzazioniOrdina la pagina di origine restituita per tempo o per visualizzazioni visibili, per esaminare le pubblicazioni recenti o i record video con più visualizzazioni.
- Record video normalizzatiRestituisce identità del video, URL pubblico, descrizione, contesto del creator, media, durata, ora di pubblicazione, metadati audio ed engagement visibile nella struttura ReelVideoItem.
Parametri della Twitch User Videos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Un nome utente pubblico di Twitch, con @ iniziale facoltativa, composto da 1–64 lettere, numeri, punti, trattini bassi o trattini. |
filter_by | Facoltativo | Tipo di origine facoltativo: all, archive, archives, highlight, highlights, upload o uploads. Gli alias dei tipi al singolare e al plurale corrispondono alla stessa categoria del provider. |
sort_by | Facoltativo | Ordinamento di origine facoltativo: time o views. |
Come usare la Twitch User Videos API
Invia un nome utente Twitch con controlli facoltativi di tipo di video e ordinamento, poi leggi l’unica pagina di origine tramite il flusso standard di attività asincrone.
- Scegli un nome utente pubblico di Twitch e decidi se la pagina di origine deve coprire tutti i video o un solo tipo di video accettato.
- Invia con POST username, filter_by e sort_by a /v1/twitch/user-videos, poi salva l’ID attività restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce; non inviare di nuovo la richiesta dopo che esiste un ID attività.
- Leggi i record ReelVideoItem da results.items e usa next_cursor solo per scorrere le righe salvate dell’attività.
curl -X POST "https://api.socq.ai/v1/twitch/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"ninja","filter_by":"all","sort_by":"time"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casi d’uso della Twitch User Videos API
- Catalogazione dei video del canale: Usa ID dei video, URL pubblici, descrizioni, riferimenti ai media, durata e contesto del creator per costruire un inventario aggiornato di un canale noto.
- Revisione del mix di formati: Esegui separatamente i filtri di tipo accettati e confronta i record di archivi, momenti salienti e caricamenti per ora di pubblicazione e durata.
- Istantanee di pubblicazione e visualizzazioni: Combina i timestamp di pubblicazione con le metriche visibili di visualizzazioni o riproduzioni e collected_at per registrare un’istantanea puntuale del canale.
Consigli degli esperti per la Twitch User Videos API
- Quando fornisci un nome utente, rimuovi gli URL dei profili e mantieni solo la @ facoltativa più i 1–64 caratteri accettati del nome utente.
- Usa time per esaminare le pubblicazioni recenti e views per esaminare i record con più visualizzazioni all’interno della pagina di origine restituita.
- Scegli in modo coerente alias dei tipi al singolare o al plurale nelle definizioni di richiesta salvate, perché ogni coppia corrisponde alla stessa categoria a monte.
- Non aggiungere cursor o results_limit al payload di invio; la chiamata al provider restituisce una pagina, mentre il cursore dei risultati dell’attività scorre solo le righe già salvate da SocQ.
- Deduplica le raccolte nel tempo per ID del video e tollera campi nullable di testo, media, audio, autore, timestamp e metriche.
API correlate
Oltre alla Twitch User Videos API, usa queste API quando ti serve un altro tipo di dati pubblici di Twitch.
- Twitch Profile API — Trasforma un nome utente Twitch pubblico in un record di account normalizzato con identità, bio, immagini, flag dell’account, metriche visibili e contesto della raccolta, se disponibili.
- Twitch Clip Downloader API — Recupera una clip pubblica di Twitch dal suo URL con titolo, visualizzazioni, durata, data di creazione, profilo dello streamer e link MP4 scaricabile con miniatura.