Modrinth badges

service for generating badges (like shields.io) for modrinth projects

There are mandatory and optional settings for each endpoint. Some settings apply only to certain endpoints, and some settings apply to all of them.

The options are used in the query string format, for example: example.com/?a=1&b=test&c=true

Applicable to all:
  1. id=abcdef (required)
    specifies the mod id for modrinth
  2. logo=true (optional)
    should the site display the modrinth logo on the badge
    logo=true logo=false
  3. style=flat (optional)
    badge style (flat by default), possible values: flat, plastic, flat-square, for-the-badge, social
    plastic flat flat-square for-the-badge social

all requests are made at the address modrinth-utils.vercel.app/api/badge/{endpoint}, where {endpoint} is the point responsible for different types of badges

/versions

returns a list of game versions

Example

Options:

  • last
    Optional: true
    Description: if true, it takes only the latest version of the mod, otherwise - all ever supported versions of the game

/followers

return the number of subscribers to the mod

Example

/downloads

returns the number of mod downloads

Example

/side

returns the side supported by the mod (client, server, client/server)

Example