API Twitch Dettagli

Q: Qual è la differenza tra Partner e Affiliate?

Sono entrambi livelli di monetizzazione di Twitch. is_affiliate indica il livello d'ingresso, mentre is_partner indica Twitch Partner, il livello più alto, un gradino sopra Affiliate. Il livello è un segnale rapido di quanto un canale sia affermato prima di parlare di una sponsorizzazione.

Q: Come capisco se uno streamer è ancora attivo?

Leggi last_broadcast_at, cioè quando è iniziata la live più recente, insieme a last_broadcast_title e last_broadcast_game. is_live, current_viewers e stream_title descrivono solo il momento della chiamata, quindi un canale offline in questo momento può comunque trasmettere regolarmente.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

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.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su twitch e action impostato su profile. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Twitch Details legge un canale tramite username e restituisce il profilo (nome visualizzato, bio, avatar, banner, follower, data di creazione), se è Partner o Affiliate, se è in live con titolo, gioco, numero di spettatori e ora di inizio attuali, e titolo, gioco e ora dell'ultima trasmissione. Per impostazione predefinita aggiunge anche i video recenti e le clip migliori. Sponsor, agenzie e team di esport la usano per valutare gli streamer, verificare che un canale sia ancora attivo e confrontare i canali prima di un accordo.

I campi della live descrivono il momento della chiamata; last_broadcast_at è il campo che distingue uno streamer attivo da uno che ha smesso. Imposta include_videos o include_clips sul booleano false per escludere quelle parti, mai sulla stringa 'false'. Le clip aggiunte qui coprono una finestra temporale diversa da quella della funzionalità Twitch Clips, che ti permette di scegliere il periodo.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Twitch Dettagli di EveryInfra (twitch/profile).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su twitch e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
  - username: Nome breve di login del canale Twitch per profile o clips, anche con prefisso @; gli URL twitch.tv completi non vengono interpretati.
- Parametri facoltativi:
  - include_clips: 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_videos: 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".
- Restituisce un oggetto. Campi principali: user_id, username, display_name, bio, url, avatar_url, banner_url, follower_count, is_partner, is_affiliate, is_live, current_viewers; 21 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=twitch.
- Esempio di corpo della richiesta:
{
  "platform": "twitch",
  "action": "profile",
  "params": {
    "username": "shroud"
  }
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`twitch`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`profile`	Identificativo della funzionalità, valore fisso.
`username`	body.params	`string`	Sì	-	Nome breve di login del canale Twitch per profile o clips, anche con prefisso @; gli URL twitch.tv completi non vengono interpretati.
`include_clips`	body.params	`boolean`	No	-	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_videos`	body.params	`boolean`	No	-	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".

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "twitch",
  "action": "profile",
  "params": {
    "username": "shroud"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "platform": "twitch",  "action": "profile",  "results": {    "user_id": "•••",    "username": "shroud",    "display_name": "shroud",    "bio": "I'm back baby",    "url": "https://www.twitch.tv/shroud",    "avatar_url": "https://static-cdn.jtvnw.net/•••",    "banner_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/dbee25e8-55b7-4565-87f0-e9d4661dcc66-profile_banner-480.jpeg",    "follower_count": 11293129,    "is_partner": true,    "is_affiliate": false,    "is_live": false,    "last_broadcast_title": "we are SAVED!",    "last_broadcast_game": "WARDOGS",    "last_broadcast_at": "2026-09-26T04:34:47.953850+00:00",    "created_at": "2012-11-03T15:50:32.878470+00:00",    "recent_videos": [      {        "id": "•••",        "title": "we are SAVED!",        "url": "https://www.twitch.tv/videos/2883804788",        "view_count": 2687,        "duration_seconds": 35971,        "game": "WARDOGS",        "created_at": "2026-09-25T18:35:12+00:00"      },      {        "id": "•••",        "title": "surely were saved..?",        "url": "https://www.twitch.tv/videos/2882888067",        "view_count": 252586,        "duration_seconds": 28465,        "game": "WARDOGS",        "created_at": "2026-09-24T17:23:48+00:00"      },      {        "id": "•••",        "title": "playing till we get ddosed",        "url": "https://www.twitch.tv/videos/2882056326",        "view_count": 194144,        "duration_seconds": 21413,        "game": "WARDOGS",        "created_at": "2026-09-23T17:50:24+00:00"      }    ],    "top_clips": [      {        "id": "•••",        "title": "wtf !!",        "url": "https://www.twitch.tv/shroud/clip/SeductiveFurryPotCmonBruh--v2IUlxXQxpw8YUZ",        "view_count": 2230,        "duration_seconds": 39,        "game": "Active Matter",        "curator_username": "•••",        "curator_name": "Taisseeer",        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f4e752a4-c4c1-42b9-a4a1-a7a28106a717/landscape/thumb/thumb-0000000000-1920x1080.jpg",        "created_at": "2026-09-19T22:08:27+00:00"      },      {        "id": "•••",        "title": "Pilot Kill",        "url": "https://www.twitch.tv/shroud/clip/BreakableAssiduousBulgogiUnSane-oAR-wxU-JuRMLxdl",        "view_count": 1042,        "duration_seconds": 21,        "game": "WARDOGS",        "curator_username": "•••",        "curator_name": "primo11119",        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f45445b1-9e8c-4cfd-88b0-d6cbe5d00b61/landscape/thumb/thumb-0000000000-1920x1080.jpg",        "created_at": "2026-09-21T18:00:52+00:00"      },      {        "id": "•••",        "title": "next level bush camper",        "url": "https://www.twitch.tv/shroud/clip/VainCloudyHawkRiPepperonis-imxaRCvFhJlfVtvo",        "view_count": 784,        "duration_seconds": 60,        "game": "WARDOGS",        "curator_username": "•••",        "curator_name": "Plot_C4",        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/84be87c7-bea1-4ed5-b709-8fdcc5482baa/landscape/thumb/thumb-0000000000-1920x1080.jpg",        "created_at": "2026-09-20T17:44:19+00:00"      }    ],    "platform": "twitch"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`user_id`	ID univoco dell'utente sulla piattaforma.
`username`	Username (@handle).
`display_name`	Nome visualizzato; può essere diverso da username.
`bio`	Bio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji.
`url`	Link al record sulla piattaforma.
`avatar_url`	Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
`banner_url`	Mantiene il significato attribuito dalla piattaforma
`follower_count`	Follower. null significa non reso noto, non 0.
`is_partner`	Mantiene il significato attribuito dalla piattaforma
`is_affiliate`	Mantiene il significato attribuito dalla piattaforma
`is_live`	Mantiene il significato attribuito dalla piattaforma
`current_viewers`	Mantiene il significato attribuito dalla piattaforma
`stream_title`	Mantiene il significato attribuito dalla piattaforma
`current_game`	Mantiene il significato attribuito dalla piattaforma
`stream_started_at`	Mantiene il significato attribuito dalla piattaforma
`last_broadcast_title`	Mantiene il significato attribuito dalla piattaforma
`last_broadcast_game`	Mantiene il significato attribuito dalla piattaforma
`last_broadcast_at`	Mantiene il significato attribuito dalla piattaforma
`created_at`	Data e ora di creazione, nello stesso formato di posted_at.
`recent_videos`	Video pubblicati di recente, ciascuno con titolo, link, numero di visualizzazioni, durata e così via; assente se non ce ne sono.
`top_clips`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Cosa devo passare come `username`?

Il nome di login del canale, come in twitch.tv/shroud, con o senza @ iniziale. I link twitch.tv completi non vengono interpretati, quindi passa solo il nome. Il nome mostrato sul canale può differire dal login: username contiene il login e display_name il nome mostrato.

Qual è la differenza tra Partner e Affiliate?

Sono entrambi livelli di monetizzazione di Twitch. is_affiliate indica il livello d'ingresso, mentre is_partner indica Twitch Partner, il livello più alto, un gradino sopra Affiliate. Il livello è un segnale rapido di quanto un canale sia affermato prima di parlare di una sponsorizzazione.

Come capisco se uno streamer è ancora attivo?

Leggi last_broadcast_at, cioè quando è iniziata la live più recente, insieme a last_broadcast_title e last_broadcast_game. is_live, current_viewers e stream_title descrivono solo il momento della chiamata, quindi un canale offline in questo momento può comunque trasmettere regolarmente.

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

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 il 2026-09-04