twitch/
profile

Trasforma un nome utente pubblico di Twitch in un record di profilo normalizzato con identità, biografia, immagini, flag dell’account, metriche visibili e contesto di raccolta.

Twitch Profile API

Input di un solo nome utente
Record normalizzato dell’account
Costo fisso per richiesta
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 Profile

Un profilo pubblico di Twitch può esporre nome utente, nome visualizzato, biografia, immagini del profilo, sito web, segnali di verifica o privacy, contesto di posizione e conteggi visibili dell’account. Il record normalizzato dell’account supporta l’arricchimento dei creator, i controlli sui profili e istantanee ripetibili di dati pubblici, senza offrire la gestione del canale né azioni autenticate sull’account.

Funzionalità della Twitch Profile API

  • Ricerca per nome utente esattoInvia un nome utente obbligatorio di 1–64 caratteri supportati, con una sola @ iniziale facoltativa.
  • Identità pubblica normalizzataLeggi ID del profilo, URL pubblico, nome utente, nome visualizzato, biografia, avatar, immagine di copertina e sito web disponibili nella specifica AccountItem.
  • Segnali sullo stato dell’accountMantieni i flag disponibili di verifica e privacy come campi nullable, invece di dedurre i valori quando il provider non li espone.
  • Metriche visibili del profiloUsa i conteggi disponibili di follower, seguiti e post come metriche facoltative separate, legate all’orario di raccolta.
  • Flusso di attività asincronoInvia il nome utente, conserva task_id, interroga il lettore di attività condiviso e recupera il risultato normalizzato salvato dopo il successo.
  • Fatturazione fissa per richiestaUn’attività riuscita ha un costo fisso di 0,19 crediti SocQ, indipendente dalla disponibilità dei campi facoltativi.

Parametri della Twitch Profile API

ParametriObbligatorioDescrizione
usernameObbligatorioNome utente Twitch obbligatorio. Dopo la rimozione degli spazi, può iniziare con una @ e deve poi contenere da 1 a 64 lettere ASCII, numeri, punti, trattini bassi o trattini.

Come usare la Twitch Profile API

Invia un nome utente Twitch supportato, segui l’attività asincrona e leggi l’unico risultato di profilo salvato tramite la risposta a cursore condivisa.

  1. Scegli un nome utente pubblico di Twitch che rispetti la regola sui caratteri supportati.
  2. Invia con POST username a /v1/twitch/profile e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
  4. Leggi data.results.items; la ricerca del profilo produce al massimo un record di origine, mentre l’envelope del risultato salvato include comunque has_more e next_cursor.
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.items

Casi d’uso della Twitch Profile API

  • Arricchimento dei record dei creator: Aggiungi identità, biografia, immagini, sito web, flag dell’account e conteggi pubblici disponibili di Twitch a un record noto di creator.
  • Flussi di verifica dei nomi utente: Trasforma un handle inviato in un profilo pubblico normalizzato prima di collegarlo a un’entità interna o a un soggetto di ricerca.
  • Confronti tra account pubblici: Confronta i conteggi visibili di follower, seguiti e post di nomi utente inviati separatamente, usando la stessa struttura AccountItem.
  • Monitoraggio delle modifiche ai profili: Salva i campi di identità nullable e le metriche con collected_at, così le esecuzioni successive restano istantanee pubbliche distinguibili.

Consigli degli esperti per la Twitch Profile API

  • Invia un nome utente e non l’URL di un canale Twitch; url e results_limit non sono campi di richiesta accettati da questo endpoint.
  • Usa una sola @ iniziale facoltativa; spazi, barre, caratteri non ASCII e @ ripetute non rispettano la regola del nome utente a runtime.
  • Aspettati zero o un record di profilo di origine. Non interpretare il parametro limit del lettore di attività come un modo per espandere un profilo in video o follower.
  • Tratta ID, URL, biografia, immagini, sito web, flag dell’account, posizione e ogni metrica come nullable e conserva collected_at per i confronti tra istantanee.
  • Usa gli altri endpoint di contenuto di Twitch, quando disponibili, per video o clip; questo endpoint è una ricerca di profilo in sola lettura e non effettua l’accesso, non pubblica, non modera né gestisce un canale.

Oltre alla Twitch Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Twitch.

Esplora altre piattaforme

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

Twitch Profile API — FAQ

Twitch Profile API è un’interfaccia che recupera un record normalizzato dell’account a partire da un nome utente pubblico di Twitch, compresi identità, biografia, immagini, flag dell’account, posizione, metriche e orario di raccolta disponibili.

Dopo la rimozione degli spazi, username accetta una @ iniziale facoltativa seguita da 1–64 lettere ASCII, numeri, punti, trattini bassi o trattini. Spazi, barre, @ aggiuntive e altri caratteri vengono rifiutati.

No. La specifica della richiesta accetta un solo username obbligatorio e rifiuta campi forniti dal chiamante come usernames, url, urls e results_limit.

Il percorso del provider risolve al massimo un oggetto profilo per il nome utente inviato. I risultati completati usano comunque l’envelope condiviso dei risultati salvati con i campi limit, has_more e next_cursor.

La specifica normalizzata consente valori null per ID, URL, nome utente, nome, biografia, immagini, sito web, verifica, privacy, posizione e singole metriche quando i dati pubblici della fonte non sono disponibili.

Ogni attività riuscita costa 0,19 crediti SocQ fissi. L’importo fisso non varia con il numero di campi facoltativi popolati nel singolo risultato di profilo.