Modrinth
Badges for Modrinth — downloads, followers, version, game versions.
Display mod stats from Modrinth, the modern Minecraft mod platform.
Downloads (branded)
Followers
Version
Game versions
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Downloads | /modrinth/downloads/{slug} | Total download count |
| Followers | /modrinth/followers/{slug} | Follower count |
| Version | /modrinth/v/{slug} | Latest version |
| Game Versions | /modrinth/game-versions/{slug} | Supported Minecraft versions |
Quick examples
Data source
Uses the Modrinth API v2. No API key required. Cached 1 hour.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
Modrinth Downloads
This section covers the modrinth/downloads badge endpoint.
Show total downloads for a Modrinth mod or modpack.
GET/modrinth/downloads/:slug.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/downloads/sodium.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/modrinth/downloads/sodium.svg?mode=light"></picture>
URL format
/modrinth/downloads/{slug}.svgCopy-paste examples
Default — total download count
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/downloads/sodium.svg?mode=dark"><img alt="downloads" src="https://shieldcn.dev/modrinth/downloads/sodium.svg?mode=light"></picture>Branded — Modrinth green
Modrinth Followers
This section covers the modrinth/followers badge endpoint.
Show the follower count for a Modrinth project.
GET/modrinth/followers/:slug.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/followers/sodium.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/modrinth/followers/sodium.svg?mode=light"></picture>
URL format
/modrinth/followers/{slug}.svgCopy-paste examples
Default — follower count
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/followers/sodium.svg?mode=dark"><img alt="followers" src="https://shieldcn.dev/modrinth/followers/sodium.svg?mode=light"></picture>Branded — Modrinth green
Modrinth Game Versions
This section covers the modrinth/game-versions badge endpoint.
Show the range of supported Minecraft versions for a Modrinth project.
GET/modrinth/game-versions/:slug.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/game-versions/sodium.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/modrinth/game-versions/sodium.svg?mode=light"></picture>
URL format
/modrinth/game-versions/{slug}.svgCopy-paste examples
Default — supported Minecraft version range
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/game-versions/sodium.svg?mode=dark"><img alt="game versions" src="https://shieldcn.dev/modrinth/game-versions/sodium.svg?mode=light"></picture>Branded — Modrinth green
Modrinth Version
This section covers the modrinth/version badge endpoint.
Show the latest published version for a Modrinth project.
GET/modrinth/v/:slug.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/v/sodium.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/modrinth/v/sodium.svg?mode=light"></picture>
URL format
/modrinth/v/{slug}.svgCopy-paste examples
Default — latest version number
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/modrinth/v/sodium.svg?mode=dark"><img alt="version" src="https://shieldcn.dev/modrinth/v/sodium.svg?mode=light"></picture>Branded — Modrinth green
