API di Twitch
Ottieni profili dei canali Twitch, stream attivi, clip più popolari e giochi per monitorare i contenuti trasmessi in diretta.
Passa il nome di login del canale, non un URL twitch.tv. Se il periodo delle clip non è valido, viene usata l'ultima settimana.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su twitch e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 6 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Twitch: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Trova canali Twitch per parola chiave, con numero di follower, stato Partner o Affiliate, stato della diretta e dettagli dell'ultima trasmissione. | Normale | |
Profiliprofile | Estrai profilo, stato Partner o Affiliate, dettagli della diretta e ultima trasmissione di un canale Twitch. | Normale | |
Clipclips | Ottieni le clip tratte da un canale Twitch. | Normale | |
Streamstreams | Elenca i canali Twitch attualmente in diretta in una categoria, con titolo dello stream, numero di spettatori, numero di follower e ora di inizio. | Normale | |
Stream più seguititop_streams | Scopri le dirette più seguite su Twitch con canale, titolo, gioco, numero di spettatori e ora di inizio, senza input. | Normale | |
Giochi più seguititop_games | Monitora i giochi più seguiti su Twitch con numero di spettatori e di streamer e box art, senza input. | Normale |
Cosa accetta ogni azione di API di Twitch?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Trova canali Twitch per parola chiave, con numero di follower, stato Partner o Affiliate, stato della diretta e dettagli dell'ultima trasmissione. Cerca i canali, non la chat, e | keyword | — | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · platform | |
profileProfili Estrai profilo, stato Partner o Affiliate, dettagli della diretta e ultima trasmissione di un canale Twitch. Video recenti e clip principali sono inclusi di default. Imposta | username | include_clips, include_videos | — | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · recent_videos · top_clips · platform | |
clipsClip Ottieni le clip tratte da un canale Twitch. Ogni clip ha titolo, visualizzazioni, durata, gioco e lo spettatore che l'ha creata. | username | period | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · title · url · view_count · duration_seconds · duration_sec · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform | |
streamsStream Elenca i canali Twitch attualmente in diretta in una categoria, con titolo dello stream, numero di spettatori, numero di follower e ora di inizio. | game | — | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | |
top_streamsStream più seguiti Scopri le dirette più seguite su Twitch con canale, titolo, gioco, numero di spettatori e ora di inizio, senza input. L'ordine non è una classifica duratura né una nostra raccomandazione. | — | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | ||
top_gamesGiochi più seguiti Monitora i giochi più seguiti su Twitch con numero di spettatori e di streamer e box art, senza input. I conteggi riguardano solo la visione su Twitch, non vendite, numero totale di giocatori o popolarità altrove. | — | Valori del catalogo: defaultLimit=10, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · name · viewer_count · broadcaster_count · box_art_url · url · platform |
Cosa significano i parametri search di API di Twitch?
Trova canali Twitch per parola chiave, con numero di follower, stato Partner o Affiliate, stato della diretta e dettagli dell'ultima trasmissione. Cerca i canali, non la chat, e is_live riflette il momento della chiamata, senza garanzie.
keywordObbligatorio- Parola chiave del canale per search. L'endpoint streams richiede il nome esatto di un gioco o di una categoria tramite game, non parole chiave arbitrarie del titolo della diretta.
Cosa significano i parametri profile di API di Twitch?
Estrai profilo, stato Partner o Affiliate, dettagli della diretta e ultima trasmissione di un canale Twitch. Video recenti e clip principali sono inclusi di default. Imposta include_videos o include_clips sul valore booleano false per escludere queste sezioni. Ricavi, nomi degli abbonati e analytics private non sono esposti.
usernameObbligatorio- Nome breve di login del canale Twitch per profile o clips, anche con prefisso @; gli URL twitch.tv completi non vengono interpretati.Twitch: nomi di login, nomi visualizzati e tipi di broadcaster — La documentazione ufficiale di Twitch definisce separatamente login, display_name e broadcaster_type. Qui username deve contenere il nome breve del canale; il nome visualizzato e il tipo Partner/Affiliate non vanno trattati come credenziali di login. Gli altri parametri supportati dalle query ufficiali sugli utenti non vengono aggiunti automaticamente a questa API. · Verificato
include_clipsFacoltativo- Valore booleano, predefinito true, che indica se la risposta di profile include le informazioni sulle clip in evidenza. La sua finestra temporale è diversa da quella dell'endpoint clips autonomo.
include_videosFacoltativo- Valore booleano, predefinito true, che indica se la risposta di profile include le informazioni sull'archivio dei video recenti. Imposta false per omettere questa sezione; non passare la stringa "false".
Cosa significano i parametri clips di API di Twitch?
Ottieni le clip tratte da un canale Twitch. Ogni clip ha titolo, visualizzazioni, durata, gioco e lo spettatore che l'ha creata. period sceglie l'ultimo giorno, l'ultima settimana (predefinito), l'ultimo mese o tutto il periodo. L'intervallo potrebbe non contenere ogni clip.
usernameObbligatorio- Nome breve di login del canale Twitch per profile o clips, anche con prefisso @; gli URL twitch.tv completi non vengono interpretati.
periodFacoltativo- Finestra temporale per clips: LAST_DAY per l'ultimo giorno, LAST_WEEK per l'ultima settimana (predefinito), LAST_MONTH per l'ultimo mese o ALL_TIME senza limiti. I valori non distinguono tra maiuscole e minuscole, e quelli non validi ricadono su LAST_WEEK.Twitch: creator delle clip, canali di origine e numero di visualizzazioni — La documentazione ufficiale di Twitch sulle clip distingue broadcaster da creator, definisce view_count come il numero di visualizzazioni della clip e duration in secondi. Questa sezione verifica solo la terminologia e non replica le date di inizio/fine ufficiali, i cursori o i parametri di creazione delle clip. · Verificato
Cosa significano i parametri streams di API di Twitch?
Elenca i canali Twitch attualmente in diretta in una categoria, con titolo dello stream, numero di spettatori, numero di follower e ora di inizio. game richiede il nome esatto della categoria, ad esempio Just Chatting, e il numero di spettatori è una fotografia del momento.
gameObbligatorio- Nome esatto della categoria Twitch per streams, ad es. Just Chatting. Restituisce i canali attualmente in diretta in quella categoria, non l'archivio storico dei video del gioco.Twitch: categorie delle live e numero di spettatori attuali — La documentazione ufficiale sulle live distingue categorie, canali e live in corso, e definisce viewer_count come il numero di utenti che stanno guardando la live in quel momento. Non è il numero di visualizzazioni di una Clip, il numero di follower o il totale storico delle visualizzazioni; il parametro ufficiale game_id non sostituisce il nome della categoria richiesto da questa pagina. · Verificato
Cosa significano i parametri top_streams di API di Twitch?
Scopri le dirette più seguite su Twitch con canale, titolo, gioco, numero di spettatori e ora di inizio, senza input. L'ordine non è una classifica duratura né una nostra raccomandazione.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statoQuesta azione non ha parametri di business. Invia solo gli identificativi della piattaforma e dell'azione.
Cosa significano i parametri top_games di API di Twitch?
Monitora i giochi più seguiti su Twitch con numero di spettatori e di streamer e box art, senza input. I conteggi riguardano solo la visione su Twitch, non vendite, numero totale di giocatori o popolarità altrove.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statoQuesta azione non ha parametri di business. Invia solo gli identificativi della piattaforma e dell'azione.
Come usare l'API di Twitch
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitch","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Twitch
Cosa posso ottenere con l'API di Twitch?
Imposta platform su twitch. Il catalogo attuale elenca ricerca, profili, clip, stream, stream più seguiti e more. Questi nomi di azione identificano oggetti o viste diversi di Twitch; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Twitch?
Parola chiave del canale per search. L'endpoint streams richiede il nome esatto di un gioco o di una categoria tramite game, non parole chiave arbitrarie del titolo della diretta. Invialo come keyword all'interno di params.
Quali campi può restituire search di Twitch?
Il suo schema dichiarato include user_id, username, display_name e bio. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Twitch rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.