twitch/
user-videos

Raccogli una pagina di video pubblici di Twitch per un nome utente, con filtri facoltativi di tipo e ordinamento, restituendo contesto del creator, media, durata ed engagement visibile.

Twitch User Videos API

Video del canale
Filtri per tipo
Engagement visibile
0,19 crediti per richiesta
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

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

ParametriObbligatorioDescrizione
usernameObbligatorioUn nome utente pubblico di Twitch, con @ iniziale facoltativa, composto da 1–64 lettere, numeri, punti, trattini bassi o trattini.
filter_byFacoltativoTipo 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_byFacoltativoOrdinamento 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.

  1. 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.
  2. Invia con POST username, filter_by e sort_by a /v1/twitch/user-videos, poi salva l’ID attività restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce; non inviare di nuovo la richiesta dopo che esiste un ID attività.
  4. 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=50

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

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.

Esplora altre piattaforme

Combina i dati di Twitch con i dati pubblici delle altre piattaforme social supportate.

Twitch User Videos API — FAQ

Twitch User Videos API è un’interfaccia programmatica per raccogliere una pagina di record video pubblici da un nome utente di Twitch. Restituisce identità normalizzata del video, descrizione, contesto del creator, media, durata, ora di pubblicazione, metadati audio ed engagement visibile.

username è obbligatorio e accetta una @ facoltativa seguita da 1–64 lettere, numeri, punti, trattini bassi o trattini. filter_by accetta all, archive, archives, highlight, highlights, upload o uploads; sort_by accetta time o views.

Ogni ReelVideoItem può includere ID, URL pubblico, descrizione, dettagli del creator, media, hashtag, menzioni, durata, metadati audio, ora di pubblicazione, orario di raccolta e Mi piace, commenti, condivisioni, riproduzioni o visualizzazioni visibili. La disponibilità nella fonte determina quali campi nullable contengono valori.

No. La specifica di invio esegue una sola richiesta alla fonte e non accetta né cursor né results_limit. Al termine, next_cursor può scorrere le righe di risultato già salvate per quell’attività, ma non recupera un’altra pagina dalla fonte.

Ogni attività riuscita usa 0,19 crediti fissi, indipendentemente dal numero di record restituiti nella pagina di origine.

Un’attività riuscita può non contenere elementi quando la pagina pubblica di origine non ha record idonei per il tipo e l’ordinamento selezionati oppure quando i video corrispondenti non sono disponibili. Tratta un risultato vuoto separatamente da un’attività non riuscita.