Gerador de Twitch User ID

User ID da Twitch: o identificador imutável por trás de cada canal

A Twitch é a plataforma de streaming ao vivo lançada em 2011 como spin-off do Justin.tv e adquirida pela Amazon em 2014 por cerca de US$ 970 milhões. Toda conta — espectador, streamer, bot, staff — recebe um User ID numérico no cadastro. Trata-se de um inteiro que cresce ao longo do tempo (não estritamente monotônico, mas em geral sim) com aproximadamente 9 a 12 dígitos em 2026, refletindo o crescimento da plataforma. O ID é o único identificador estável do usuário, enquanto o login/username visível pode ser alterado a cada 60 dias.

User ID vs login vs display name

• User ID — numérico, imutável, chave primária. Sempre persista esse valor no seu banco.
• Login — handle ASCII em minúsculas usado nas URLs (twitch.tv/<login>). Mutável.
• Display name — preserva caixa alta/baixa e pode incluir alguns caracteres não-ASCII; só cosmético.
• Channel ID — na Twitch, canal e usuário são a mesma entidade, então o Channel ID é igual ao User ID.
• Stream ID — conceito distinto: é gerado por sessão ao vivo e muda toda vez que o streamer inicia uma nova transmissão.

Lookup de ID via API Helix

A API pública REST atual chama-se Helix e substituiu os endpoints obsoletos da Kraken (v5) em fevereiro de 2022. Um lookup típico por login fica assim:

GET https://api.twitch.tv/helix/users?login=xqc
Authorization: Bearer <app_access_token>
Client-Id: <your_client_id>

→ { "data": [ { "id": "71092938", "login": "xqc", ... } ] }

Eventos em tempo real eram entregues via PubSub; a Twitch está migrando tudo gradualmente para o EventSub (webhooks + WebSocket). O chat ainda roda sobre um gateway IRC customizado, herança da época do Justin.tv. A autenticação usa OAuth 2.0 com tokens por escopo, e os rate limits ficam em torno de 800 pontos por minuto no bucket autenticado.

Casos de uso para IDs sintéticos

IDs de usuário Twitch verossímeis são úteis para popular bancos de bots (StreamElements, Streamlabs, Nightbot), prototipar overlays browser-source do OBS, montar dashboards de analytics ou escrever testes que precisem percorrer um ID pelo cliente Helix sem bater na rede. IDs abaixo de 1.000 são reservados em grande parte para o staff original do Justin.tv e contas legadas — evite-os em fixtures.

Perguntas frequentes

O User ID muda quando renomeio meu canal? Não. O login pode mudar a cada 60 dias, mas o User ID numérico é fixo durante toda a vida da conta — exatamente por isso ferramentas terceiras se ancoram nele.

Consigo descobrir o ID a partir do username? Sim, o endpoint Helix /users?login=<nome> devolve o ID, a foto de perfil, o tipo de broadcaster e a data de criação da conta.

Os IDs são estritamente monotônicos? Não estritamente. Em geral são atribuídos em ordem cronológica aproximada, mas a Twitch já distribuiu blocos fora de ordem para contas migradas ou legadas — não confie no valor para inferir data de cadastro com precisão.

É seguro expor o User ID publicamente? Sim — ele já aparece em toda resposta da API e está embutido nos URLs de clipes, VODs e badges de chat. Trate como identificador público, não como segredo.