Panorama de la API de Modrinth — Cómo la consultan las herramientas

Para qué sirve la API

Modrinth expone una API REST pública en api.modrinth.com/v2 que permite a herramientas de terceros (este conversor incluido) consultar proyectos, listar versiones y obtener URL de descarga sin raspar la web.

Endpoints útiles para herramientas de modpacks

GET /project/{id|slug}

Devuelve los metadatos del proyecto: título, descripción, tipo (mod, modpack, paquete de recursos), miembros del equipo y licencia.

GET /project/{id}/version

Lista todas las versiones publicadas de un proyecto, de más reciente a más antigua. Cada entrada incluye la URL de descarga del archivo principal y un hash SHA-512.

GET /version_file/{hash}?algorithm=sha512

Búsqueda inversa: dado un hash, encuentra la versión que lo generó. Muy útil para verificar ZIP convertidos.

Límites de uso

Modrinth aplica límites generosos para el uso anónimo (300 peticiones por minuto). El conversor agrupa sus peticiones cuando puede y respeta las cabeceras Retry-After .

Autenticación

La mayoría de endpoints de lectura funcionan de forma anónima. Las peticiones autenticadas (publicar, editar) requieren un token de cuenta de Modrinth, que el conversor nunca pide porque no modifica contenido de Modrinth.