Validador de IMDb ID

O que e um IMDb ID e por que todo workflow cinefilo acaba usando

O IMDb ID e o identificador unico canonico atribuido pelo Internet Movie Database a cada titulo, pessoa, empresa ou evento de seu catalogo. Criado em 1990 como projeto hobby na Usenet e comprado pela Amazon em 1998, hoje o IMDb cobre mais de 11 milhoes de titulos e 13 milhoes de pessoas. Como o catalogo e grande e antigo, o IMDb ID virou a lingua franca entre agregadores de streaming, sistemas de recomendacao e estudos academicos de cinema — ate concorrentes como TMDb e Letterboxd guardam o IMDb ID como chave estrangeira.

Formato do ID: prefixos e padding com zeros

Todo IMDb ID e um prefixo de duas letras seguido de digitos. O prefixo nao muda apos a emissao, entao serve como token de roteamento:

• tt + 7 ou 8 digitos — titulo (filme, serie, episodio, curta, video game). Exemplo: tt0111161 para Um Sonho de Liberdade, atualmente #1 no IMDb Top 250.
• nm + digitos — nome de pessoa (ator, diretor, equipe). Exemplo: nm0000093 para Brad Pitt.
• co + digitos — empresa (producao, distribuicao, estudio). Exemplo: co0144901 para a Globo Filmes.
• ev + digitos — evento (premiacoes, festivais). Exemplo: ev0000003 para o Oscar.
• Prefixos menos comuns: ch personagens, ni noticias, rg release groups.

Os numeros sao preenchidos com zeros a esquerda para manter ordenacao lexicografica e numerica alinhadas. tt0000001 e Carmencita (1894, Edison Studios), o primeiro titulo cadastrado. Hoje os IDs ja passam de tt2 milhoes para titulos e nm14 milhoes para pessoas, entao qualquer parser robusto deve aceitar tamanho variavel apos o prefixo.

^(tt|nm|co|ev|ch|ni|rg)[0-9]{7,8}$

Onde os IMDb IDs alimentam produtos downstream

• TMDb (The Movie Database) — colaborativo, API gratuita, espelha o IMDb ID em external_ids.imdb_id. Usado por Plex, Jellyfin, Stremio, Radarr/Sonarr.
• JustWatch — busca de streaming brasileira consulta IMDb IDs para Netflix, Prime Video, Globoplay, Max, Apple TV+, Disney+.
• Trakt.tv — historico de visualizacao indexado por IMDb ID.
• Letterboxd — rede social de cinema cuja base e construida sobre o TMDb e guarda o IMDb ID para exportacao e cross-reference.
• Wikidata / Wikipedia — propriedade P345 armazena o IMDb ID de cada filme notavel, permitindo consultas SPARQL pela historia do cinema.
• Datasets academicos — o IMDb publica datasets gratuitos nao comerciais (title.basics.tsv.gz, name.basics.tsv.gz) muito usados em pesquisa de sistemas de recomendacao.

APIs que voce precisa conhecer

O proprio IMDb nao oferece API publica gratuita. Existem tres caminhos legitimos:

• OMDb API (omdbapi.com) — wrapper comunitario popular, 1.000 requisicoes gratuitas por dia, aceita o IMDb ID direto como i=tt0111161.
• TMDb API — totalmente gratuita para uso nao comercial, multilingue, metadata muito mais rica; o endpoint /3/find/{imdb_id}?external_source=imdb_id faz a ponte entre as duas bases.
• Datasets nao comerciais do IMDb — arquivos TSV em massa atualizados diariamente, ideais para analytics offline. Licenca comercial e exigida para produtos pagos.

Fazer scraping do HTML do IMDb e tecnicamente possivel mas ativamente desencorajado: rate limit agressivo, captchas e os Termos de Servico proibem. APIs sao sempre a rota mais segura.

Matematica da nota IMDb e diferenca para outras pontuacoes

A nota IMDb principal e uma media ponderada de todos os votos, escala 1–10. Para entrar no Top 250, porem, o filme precisa cumprir uma cota de votos (atualmente acima de 25.000) e e recalculado por uma formula Bayesiana:

WR = (v / (v + m)) * R + (m / (v + m)) * C

em que R = media do titulo, v = votos recebidos, m = votos minimos exigidos, C = media geral entre todos os titulos elegiveis. Isso suaviza outliers com poucos votos e e por isso que um blockbuster recente raramente passa Um Sonho de Liberdade. Outros sistemas usam matematica bem diferente: o Rotten Tomatoes Tomatometer e a porcentagem de criticos com veredito "positivo" (julgamento binario agregado como razao), enquanto o Metacritic calcula media ponderada de notas criticas normalizadas em 0–100.

Cinema brasileiro no IMDb

Filmes brasileiros figuram no IMDb por causa de festivais internacionais. IDs notaveis: tt0317248 Cidade de Deus, tt0861739 Tropa de Elite, tt1098327 Tropa de Elite 2, tt0118842 Central do Brasil, tt21807222 Ainda Estou Aqui (2024). Parceiros de streaming Globoplay, Crunchyroll BR e os catalogos locais de Netflix e Prime Video apontam para IMDb IDs para cross-promotion e SEO.

FAQ

Qual a diferenca entre tt e nm? tt identifica um titulo (filme, serie, episodio), nm identifica um nome (pessoa). Nunca se sobrepoem, entao um unico regex roteia requisicoes pelo prefixo.

Existe API gratuita do IMDb? Diretamente nao. As alternativas gratuitas mais proximas sao a OMDb (1k req/dia) e a TMDb (uso nao comercial ilimitado). Ambas aceitam o IMDb ID como chave de consulta.

O ID pode ter menos de 7 digitos? Oficialmente sim para registros muito antigos (tt0000001), mas sempre preenchido com zeros para chegar a no minimo 7. Alocacoes modernas tem 7 ou 8 digitos.

Os dados do IMDb sao confiaveis? Parcialmente. Sao crowdsourced com aprovacao editorial, mas existem viesses (vote brigading, ratings prematuros). Em pesquisa academica prefira os snapshots dos datasets e registre o timestamp da consulta.

Como descobrir o IMDb ID a partir do titulo? O endpoint de busca da OMDb ou da TMDb e o caminho mais simples. Ambos aceitam consultas fuzzy por titulo e retornam o IMDb ID canonico.