Validador de IMDb ID

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

O IMDb ID e o identificador único canônico atribuído pelo Internet Movie Database a cada titulo, pessoa, empresa ou evento de seu catálogo. Criado em 1990 como projeto hobby na Usenet e comprado pela Amazon em 1998, hoje o IMDb cobre mais de 11 milhões de titulos e 13 milhões de pessoas. Como o catálogo e grande e antigo, o IMDb ID virou a língua franca entre agregadores de streaming, sistemas de recomendação e estudos academicos de cinema — até 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 dígitos. O prefixo não muda após a emissão, então serve como token de roteamento:

• tt + 7 ou 8 dígitos — titulo (filme, série, episodio, curta, vídeo game). Exemplo: tt0111161 para Um Sonho de Liberdade, atualmente #1 no IMDb Top 250.
• nm + dígitos — nome de pessoa (ator, diretor, equipe). Exemplo: nm0000093 para Brad Pitt.
• co + dígitos — empresa (produção, distribuição, estúdio). Exemplo: co0144901 para a Globo Filmes.
• ev + dígitos — evento (premiacoes, festivais). Exemplo: ev0000003 para o Oscar.
• Prefixos menos comuns: ch personagens, ni noticias, rg release groups.

Os números são preenchidos com zeros a esquerda para manter ordenacao lexicografica e numérica alinhadas. tt0000001 e Carmencita (1894, Edison Studios), o primeiro titulo cadastrado. Hoje os IDs ja passam de tt2 milhões para titulos e nm14 milhões para pessoas, então qualquer parser robusto deve aceitar tamanho variável após 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 Vídeo, Globoplay, Max, Apple TV+, Disney+.
• Trakt.tv — histórico de visualizacao indexado por IMDb ID.
• Letterboxd — rede social de cinema cuja base e construída sobre o TMDb e guarda o IMDb ID para exportação e cross-reference.
• Wikidata / Wikipedia — propriedade P345 armazena o IMDb ID de cada filme notavel, permitindo consultas SPARQL pela história do cinema.
• Datasets academicos — o IMDb publica datasets gratuitos não comerciais (title.basics.tsv.gz, name.basics.tsv.gz) muito usados em pesquisa de sistemas de recomendação.

APIs que você precisa conhecer

O próprio IMDb não oferece API publica gratuita. Existem três caminhos legitimos:

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

Fazer scraping do HTML do IMDb e tecnicamente possível mas ativamente desencorajado: rate limit agressivo, captchas e os Termos de Serviço proibem. APIs são sempre a rota mais segura.

Matemática da nota IMDb e diferença para outras pontuacoes

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

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

em que R = média do titulo, v = votos recebidos, m = votos minimos exigidos, C = média 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 matemática bem diferente: o Rotten Tomatoes Tomatometer e a porcentagem de criticos com veredito "positivo" (julgamento binario agregado como razão), enquanto o Metacritic calcula média 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 catálogos locais de Netflix e Prime Vídeo apontam para IMDb IDs para cross-promotion e SEO.

FAQ

Qual a diferença entre tt e nm? tt identifica um titulo (filme, série, episodio), nm identifica um nome (pessoa). Nunca se sobrepoem, então um único regex roteia requisições pelo prefixo.

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

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

Os dados do IMDb são confiaveis? Parcialmente. São 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 canônico.