Modrinth Badge - Unofficial

A little badge/shield for mods on Modrinth

API documentation for modrinth.roughness.technology. An unofficial badge API for Modrinth mods/modpacks/etc.

Modrinth Badge API Usage

The base url is https://modrinth.roughness.technology. HTTPS Only.

/{project}.svg

{project} can either be the id or slug

  • actually-harvest.svg -> https://modrinth.roughness.technology/actually-harvest.svg
  • sUbuUC7R.svg -> https://modrinth.roughness.technology/sUbuUC7R.svg

/{style}_{project}_{extra}.svg

{style} can either be 'short' or 'full', extra is optional text to be appended.

  • short_actually-harvest.svg -> https://modrinth.roughness.technology/short_actually-harvest.svg
  • full_actually-harvest_downloads.svg -> https://modrinth.roughness.technology/full_actually-harvest_downloads.svg

/versions/{project}.svg

{project} can either be the id or slug

Only returns one of: 1.6.4, 1.7.10, 1.8.9, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.16.5, 1.18.2, 1.20.1, 1.21.1, 26.1.2, 26.2

Versions will be updated in the future as they are released/stabilized

  • Versions actually-harvest.svg -> https://modrinth.roughness.technology/versions/actually-harvest.svg
  • Versions sUbuUC7R.svg -> https://modrinth.roughness.technology/versions/sUbuUC7R.svg

/versions/{text}_{project}_{style}.svg

{text} is optional and replaces the default 'Available for' text. {style} can either be 'all' or 'latest'.

Only returns one of: 1.6.4, 1.7.10, 1.8.9, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.16.5, 1.18.2, 1.20.1, 1.21.1, 26.1.2, 26.2

Versions will be updated in the future as they are released/stabilized

  • actually-harvest_latest.svg -> https://modrinth.roughness.technology/actually-harvest_latest.svg
  • For MC actually-harvest_all.svg -> https://modrinth.roughness.technology/versions/For%20MC_actually-harvest_all.svg

/author/{name}.svg

{name} can either be the id or username

  • wendall911.svg -> https://modrinth.roughness.technology/author/wendall911.svg
  • modmuss50.svg -> https://modrinth.roughness.technology/author/modmuss50.svg

/author/{style}_{project}_{extra}.svg

{style} can either be 'short' or 'full', extra is optional text to be appended.

{style} can either be 'short' or 'full', extra is optional text to be appended.

  • short_wendall911.svg -> https://modrinth.roughness.technology/author/short_wendall911.svg
  • full_modmuss50_downloads.svg -> https://modrinth.roughness.technology/author/full_modmuss50_downloads.svg

Alternate Badge Styles

Using the get param badge_style allows for changing the style. Currently only option is flat

  • wendall911.svg -> https://modrinth.roughness.technology/author/wendall911.svg
  • wendall911.svg flat -> https://modrinth.roughness.technology/author/wendall911.svg?badge_style=flat

Not an official API.

Roughness Technology, LLC hosts this API as a courtesy for mod developers using Modrinth.

Roughness Technology, LLC and this site are not affiliated with Modrinth.