Visão geral da API do Modrinth — Como as ferramentas consultam o Modrinth

Para que serve a API

O Modrinth expõe uma API REST pública em api.modrinth.com/v2 que permite a ferramentas de terceiros (inclusive este conversor) consultar projetos, listar versões e obter URLs de download sem raspar o site.

Endpoints úteis para ferramentas de modpack

GET /project/{id|slug}

Retorna os metadados do projeto: título, descrição, tipo (mod, modpack, pacote de recursos), integrantes da equipe e licença.

GET /project/{id}/version

Lista todas as versões publicadas de um projeto, da mais recente para a mais antiga. Cada entrada traz a URL de download do arquivo principal e um hash SHA-512.

GET /version_file/{hash}?algorithm=sha512

Busca reversa: dado um hash, encontra a versão que o gerou. Útil para verificar ZIPs convertidos.

Limites de requisição

O Modrinth aplica limites generosos para uso anônimo (300 requisições por minuto). O conversor agrupa as requisições quando possível e respeita os cabeçalhos Retry-After .

Autenticação

A maioria dos endpoints de leitura funciona sem login. Requisições autenticadas (publicar, editar) exigem um token de conta do Modrinth, que o conversor nunca pede, já que não altera conteúdo do Modrinth.