Modrinth

App · 19 actions

Search Modrinth for Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers by loader, Minecraft version and category. Read a project's versions, files, dependencies and team, identify mod files by their hash and check them for updates, and look up users. A trigger runs a workflow when a project publishes a new version. No account or API key required.

Actions

ActionWhat it does
Check a project existsCheck whether a Modrinth project has this slug or ID, and get its ID.
Check files for updatesCheck mod files for newer versions, from their hashes, up to 100 at a time: for each, the version it is, the newest version that fits the loaders, Minecraft versions and release channels given, and whether that is an update, with its download link.
Get a projectGet everything about one Modrinth project: its summary and full description page, type, categories, loaders, Minecraft versions, downloads and followers, licence, links to its source, issues, wiki and Discord, donation links and gallery.
Get a project's dependenciesFind what a project needs to run, and what it refuses to run with: each project its versions name, whether it is required, optional, shipped inside or incompatible, and in how many versions.
Get a userGet a Modrinth user's public profile: username, bio, profile picture, role and when they joined.
Get a versionGet one version by its ID: its changelog, files with download links and hashes, loaders, Minecraft versions and dependencies.
Get a version by its numberGet a project's version by the version number its authors gave it, such as '0.5.11', with its changelog, files, download links and dependencies.
Get licence textGet the full text of a standard licence by its SPDX ID, such as a project's 'MIT' or 'LGPL-3.0-only'.
Get random projectsGet projects picked at random from all of Modrinth, for a 'discover something new' post or a varied sample.
Get several projectsGet up to 100 Modrinth projects in one step, by slug or ID, with their downloads, followers, loaders, licence and last update.
Get statisticsGet how many projects, versions, files and authors Modrinth holds, for tracking the platform's growth.
Identify files by hashFind which project and version each mod file belongs to, from its SHA-1 or SHA-512 hash, up to 100 at a time.
List a project's teamList the people on a project's team with their roles, such as Owner or Maintainer.
List a project's versionsList a project's versions, newest first, with their files, download links, hashes, loaders, Minecraft versions and dependencies.
List a user's projectsList the projects a Modrinth user publishes, most downloaded first, with their downloads added up.
List categoriesList the categories projects are filed under on Modrinth, such as Optimization, Worldgen or 16x, with the project type each belongs to.
List loadersList the loaders and platforms Modrinth knows, such as Fabric, NeoForge, Paper or Iris, with the project types each is used for.
List Minecraft versionsList Minecraft versions, newest first, with the date each came out: releases by default, or snapshots, old betas and alphas.
Search projectsFind Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers on Modrinth by name or words, narrowed by type, category, loader, Minecraft version, whether it runs in the player's game or on a server, and open source.

Check a project exists

Check whether a Modrinth project has this slug or ID, and get its ID. A slug nobody uses comes back with 'found' set to false rather than failing the step. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

Outputs

foundtrue/false
Whether a project has that slug or ID.
idtext
The project's ID, when it exists.
searched_fortext
The slug or ID that was checked.
urltext
The project's page on modrinth.com, when it exists.
Example output
{
  "found": true,
  "id": "AANobbMI",
  "searched_for": "sodium",
  "url": "https://modrinth.com/project/AANobbMI"
}

Check files for updates

Check mod files for newer versions, from their hashes, up to 100 at a time: for each, the version it is, the newest version that fits the loaders, Minecraft versions and release channels given, and whether that is an update, with its download link. Give the loader and Minecraft version you play to stay on them. No API key required.

Inputs

File hasheshasheslistRequired
The SHA-1 or SHA-512 hash of each file, up to 100. Both kinds can be mixed: which is which is read from its length. Launchers and modpack files (modrinth.index.json) list these for every mod.
Loadersloaderslist
Only updates for these loaders, such as Fabric. Leave empty for any loader, which may offer a version for a different loader.
Minecraft versionsgame_versionslist
Only updates for these Minecraft versions. Leave empty to allow any, including newer Minecraft versions.
Release channelsversion_typeslist
Only updates in these channels, such as Release alone to skip betas. Leave empty for any channel.One or more of: release, beta, alpha.

Outputs

countnumber
How many hashes were checked.
fileslist
One answer per hash, in the order given.
not_found_countnumber
How many hashes Modrinth doesn't know.
update_countnumber
How many files have a newer version.
Example output
{
  "count": 2,
  "files": [
    {
      "algorithm": "sha1",
      "current_version_id": "SMxNOGZ6",
      "current_version_number": "mc1.21.1-0.8.13-fabric",
      "found": true,
      "hash": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
      "latest_date_published": "2026-09-15T15:57:23.369305Z",
      "latest_download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/bAZQdGpg/sodium-fabric-0.9.2%2Bmc26.3.jar",
      "latest_file_name": "sodium-fabric-0.9.2+mc26.3.jar",
      "latest_found": true,
      "latest_game_versions": [
        "26.3"
      ],
      "latest_loaders": [
        "fabric"
      ],
      "latest_sha1": "9acfe851e36f4fb27d7c5baa224e8bd4e0334283",
      "latest_url": "https://modrinth.com/project/AANobbMI/version/bAZQdGpg",
      "latest_version_id": "bAZQdGpg",
      "latest_version_number": "mc26.3-0.9.2-fabric",
      "latest_version_type": "release",
      "project_id": "AANobbMI",
      "project_title": "Sodium",
      "update_available": true
    },
    {
      "algorithm": "sha1",
      "current_version_id": null,
      "current_version_number": null,
      "found": false,
      "hash": "0000000000000000000000000000000000000000",
      "latest_date_published": null,
      "latest_download_url": null,
      "latest_file_name": null,
      "latest_found": false,
      "latest_game_versions": [],
      "latest_loaders": [],
      "latest_sha1": null,
      "latest_url": null,
      "latest_version_id": null,
      "latest_version_number": null,
      "latest_version_type": null,
      "project_id": null,
      "project_title": null,
      "update_available": false
    }
  ],
  "not_found_count": 1,
  "update_count": 1
}

Get a project

Get everything about one Modrinth project: its summary and full description page, type, categories, loaders, Minecraft versions, downloads and followers, licence, links to its source, issues, wiki and Discord, donation links and gallery. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

Outputs

bodytext
The project's full description page, written in Markdown.
categorieslist
The categories it is filed under, such as 'optimization'.
client_sidetext
Whether players need it installed: 'required', 'optional' or 'unsupported' (or 'unknown'). A mod that is 'unsupported' on the server only needs installing by players.
descriptiontext
The project's one-line summary.
discord_urltext
Its Discord invite, when given.
donation_urlslist
Where to support its authors.
downloadsnumber
How many times its files have been downloaded.
followersnumber
How many Modrinth users follow it.
gallerylist
Its gallery images.
game_versionslist
Every Minecraft version it has a file for, oldest first.
icon_urltext
The address of its icon image.
idtext
The project's ID, such as 'AANobbMI'. It never changes.
issues_urltext
Where to report bugs, when given.
license_idtext
Its licence's SPDX ID, such as 'MIT', or a 'LicenseRef-' ID for a licence of its own.
license_nametext
Its licence's full name, or its ID when Modrinth has none.
license_urltext
A link to its licence text, when the project gives one.
loaderslist
The loaders it runs on, such as 'fabric' or 'neoforge'.
organization_idtext
The ID of the organization that owns it, when one does.
project_typetext
What it is: mod, modpack, resourcepack, shader, plugin, datapack or minecraft_java_server.
publishedtext
When it was first published, as an ISO 8601 date and time.
server_sidetext
Whether a server needs it installed: 'required', 'optional' or 'unsupported' (or 'unknown'). A mod that is 'unsupported' on the server only needs installing by players.
slugtext
The project's slug, the readable name in its address, such as 'sodium'. Every action that takes a project accepts it.
source_urltext
Where its source code is, when given.
statustext
Its status on Modrinth, normally 'approved'.
team_idtext
The ID of the team that maintains it.
titletext
The project's name, such as 'Sodium'.
updatedtext
When it last changed, as an ISO 8601 date and time.
urltext
Its page on modrinth.com.
wiki_urltext
Its wiki or documentation, when given.
Example output
{
  "body": "## Installation\n\nYou can find a guide to installation [here](https://github.com/IrisShaders/Iris/blob/multiloader-new/docs/guide.md).",
  "categories": [
    "decoration",
    "optimization"
  ],
  "client_side": "required",
  "description": "A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs",
  "discord_url": "https://discord.gg/jQJnav2jPu",
  "donation_urls": [
    {
      "platform": "Patreon",
      "url": "https://www.patreon.com/ims21"
    }
  ],
  "downloads": 194678462,
  "followers": 30170,
  "gallery": [
    {
      "description": "Complementary Shaders 4.4 dev5",
      "featured": false,
      "title": "A nice sunset",
      "url": "https://cdn.modrinth.com/data/YL57xq9U/images/17f09a3d424d6e2005fcecc81838780a6847f8ce_350.webp"
    }
  ],
  "game_versions": [
    "26.1.2",
    "26.2",
    "26.3"
  ],
  "icon_url": "https://cdn.modrinth.com/data/YL57xq9U/18d0e7f076d3d6ed5bedd472b853909aac5da202_96.webp",
  "id": "YL57xq9U",
  "issues_url": "https://github.com/IrisShaders/Iris/issues",
  "license_id": "LGPL-3.0-only",
  "license_name": "GNU Lesser General Public License v3.0 only",
  "license_url": null,
  "loaders": [
    "fabric",
    "neoforge",
    "quilt"
  ],
  "organization_id": null,
  "project_type": "mod",
  "published": "2021-05-27T05:11:15.690120Z",
  "server_side": "unsupported",
  "slug": "iris",
  "source_url": "https://github.com/IrisShaders/Iris",
  "status": "approved",
  "team_id": "1HMZl6Mn",
  "title": "Iris Shaders",
  "updated": "2026-09-30T02:58:24.095409Z",
  "url": "https://modrinth.com/mod/iris",
  "wiki_url": null
}

Get a project's dependencies

Find what a project needs to run, and what it refuses to run with: each project its versions name, whether it is required, optional, shipped inside or incompatible, and in how many versions. Narrow to a loader and Minecraft version for the exact answer for one setup. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Loadersloaderslist
Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
Minecraft versionsgame_versionslist
Only versions for these Minecraft versions. Any one of them is enough. The list offers release versions; type a snapshot such as '26.4-snapshot-4' to use one. Leave empty for every Minecraft version.

Outputs

countnumber
How many projects are named.
dependencieslist
Each project its versions name, required ones first.
external_fileslist
Files from outside Modrinth that versions name.
projecttext
The project whose versions were read.
required_countnumber
How many of them are required.
versions_checkednumber
How many of its versions were read: the ones matching the filters.
Example output
{
  "count": 1,
  "dependencies": [
    {
      "dependency_types": [
        "required"
      ],
      "downloads": 251168597,
      "project_id": "AANobbMI",
      "project_type": "mod",
      "required": true,
      "slug": "sodium",
      "title": "Sodium",
      "url": "https://modrinth.com/mod/sodium",
      "version_count": 10
    }
  ],
  "external_files": [],
  "project": "iris",
  "required_count": 1,
  "versions_checked": 12
}

Get a user

Get a Modrinth user's public profile: username, bio, profile picture, role and when they joined. No API key required.

Inputs

UserusertextRequired
A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.

Outputs

avatar_urltext
The address of their profile picture.
biotext
What they wrote about themselves.
createdtext
When they joined, as an ISO 8601 date and time.
idtext
The user's ID, such as 'TEZXhE2U'.
nametext
The display name they chose, when they set one.
roletext
Their role on Modrinth: developer, moderator or admin.
urltext
Their profile page on modrinth.com.
usernametext
Their username, such as 'jellysquid3'.
Example output
{
  "avatar_url": "https://avatars2.githubusercontent.com/u/4324090?v=4",
  "bio": null,
  "created": "2020-12-08T21:41:49.550067Z",
  "id": "JZA4dW8o",
  "name": null,
  "role": "developer",
  "url": "https://modrinth.com/user/modmuss50",
  "username": "modmuss50"
}

Get a version

Get one version by its ID: its changelog, files with download links and hashes, loaders, Minecraft versions and dependencies. No API key required.

Inputs

Version IDversion_idtextRequired
The version's ID, such as 'SMxNOGZ6', as 'List a project's versions' or a search's newest version ID gives it.

Outputs

changelogtext
What changed in this version, written in Markdown.
date_publishedtext
When it was published, as an ISO 8601 date and time.
dependencieslist
What this version needs, or refuses to run with.
download_urltext
The address to download its main file from.
downloadsnumber
How many times it has been downloaded.
file_nametext
Its main file's name.
file_sizenumber
Its main file's size in bytes.
fileslist
Every file in the version, the main one included.
game_versionslist
The Minecraft versions it works with.
idtext
The version's ID, such as 'SMxNOGZ6'.
loaderslist
The loaders it works with, such as 'fabric'.
nametext
The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
project_idtext
The ID of the project it belongs to.
sha1text
Its main file's SHA-1 hash.
sha512text
Its main file's SHA-512 hash.
statustext
Its status, normally 'listed'.
urltext
The version's page on modrinth.com.
version_numbertext
Its version number, such as 'mc1.21.1-0.8.13-fabric'.
version_typetext
Its release channel: release, beta or alpha.
Example output
{
  "changelog": "Sodium 0.8.13 fixes potential minor bugs and improves the crash log message to avoid misattribution of unrelated errors when NeoForge continues loading despite severe errors.",
  "date_published": "2026-08-28T20:55:02.424329Z",
  "dependencies": [],
  "download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
  "downloads": 1786271,
  "file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
  "file_size": 1574609,
  "files": [
    {
      "file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
      "file_type": null,
      "primary": true,
      "sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
      "sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
      "size": 1574609,
      "url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar"
    }
  ],
  "game_versions": [
    "1.21.1"
  ],
  "id": "SMxNOGZ6",
  "loaders": [
    "fabric"
  ],
  "name": "Sodium 0.8.13 for Fabric 1.21.1",
  "project_id": "AANobbMI",
  "sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
  "sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
  "status": "listed",
  "url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
  "version_number": "mc1.21.1-0.8.13-fabric",
  "version_type": "release"
}

Get a version by its number

Get a project's version by the version number its authors gave it, such as '0.5.11', with its changelog, files, download links and dependencies. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Version numberversion_numbertextRequired
The version number exactly as the project writes it, such as 'mc1.21.1-0.8.13-fabric'. A version ID works too.

Outputs

changelogtext
What changed in this version, written in Markdown.
date_publishedtext
When it was published, as an ISO 8601 date and time.
dependencieslist
What this version needs, or refuses to run with.
download_urltext
The address to download its main file from.
downloadsnumber
How many times it has been downloaded.
file_nametext
Its main file's name.
file_sizenumber
Its main file's size in bytes.
fileslist
Every file in the version, the main one included.
game_versionslist
The Minecraft versions it works with.
idtext
The version's ID, such as 'SMxNOGZ6'.
loaderslist
The loaders it works with, such as 'fabric'.
nametext
The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
project_idtext
The ID of the project it belongs to.
sha1text
Its main file's SHA-1 hash.
sha512text
Its main file's SHA-512 hash.
statustext
Its status, normally 'listed'.
urltext
The version's page on modrinth.com.
version_numbertext
Its version number, such as 'mc1.21.1-0.8.13-fabric'.
version_typetext
Its release channel: release, beta or alpha.
Example output
{
  "changelog": "Sodium 0.8.13 fixes potential minor bugs and improves the crash log message to avoid misattribution of unrelated errors when NeoForge continues loading despite severe errors.",
  "date_published": "2026-08-28T20:55:02.424329Z",
  "dependencies": [],
  "download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
  "downloads": 1786271,
  "file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
  "file_size": 1574609,
  "files": [
    {
      "file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
      "file_type": null,
      "primary": true,
      "sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
      "sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
      "size": 1574609,
      "url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar"
    }
  ],
  "game_versions": [
    "1.21.1"
  ],
  "id": "SMxNOGZ6",
  "loaders": [
    "fabric"
  ],
  "name": "Sodium 0.8.13 for Fabric 1.21.1",
  "project_id": "AANobbMI",
  "sha1": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
  "sha512": "8614a374593698069a80ac74de8cd9c28f3928d16819a0e0d6320b538e823f7e54e8be06d5ea5a9c268beb0e02073209d1f831a02dede851588b972367680853",
  "status": "listed",
  "url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
  "version_number": "mc1.21.1-0.8.13-fabric",
  "version_type": "release"
}

Get licence text

Get the full text of a standard licence by its SPDX ID, such as a project's 'MIT' or 'LGPL-3.0-only'. A project with a licence of its own links to it instead. No API key required.

Inputs

Licencelicense_idtextRequired
The licence, as a project's licence ID gives it, such as 'MIT' or 'Apache-2.0'.

Outputs

bodytext
The licence's full text.
idtext
The licence's SPDX ID.
titletext
The licence's full name.
Example output
{
  "body": "GNU LESSER GENERAL PUBLIC LICENSE\nVersion 3, 29 June 2007\n\nCopyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>\n\nEveryone is permitted to copy an",
  "id": "LGPL-3.0-only",
  "title": "GNU Lesser General Public License v3.0 only"
}

Get random projects

Get projects picked at random from all of Modrinth, for a 'discover something new' post or a varied sample. No API key required.

Inputs

How manycountnumber
How many projects to pick, up to 100.From 1 to 100. Default: 10.

Outputs

countnumber
How many projects came back.
projectslist
The projects Modrinth picked.
Example output
{
  "count": 2,
  "projects": [
    {
      "categories": [
        "mobs",
        "transportation"
      ],
      "client_side": "optional",
      "description": "Part of the Cobblemon Hacked Changes series, I am now separating my one mod into separate Datapacks. This datapack targets doduo and dodrio from generation one.",
      "downloads": 52,
      "followers": 0,
      "icon_url": "https://cdn.modrinth.com/data/6dyhwzlE/1390d667320635f24347fa8246c87d38378a4a89.png",
      "id": "6dyhwzlE",
      "license_id": "MPL-2.0",
      "loaders": [
        "datapack"
      ],
      "project_type": "mod",
      "published": "2026-08-18T23:48:17.410126Z",
      "server_side": "required",
      "slug": "dodrio-and-doduo-hacked-changes",
      "status": "approved",
      "title": "0084-0085 Dodrio Line Hacked Changes",
      "updated": "2026-09-20T19:27:15.080633Z",
      "url": "https://modrinth.com/mod/dodrio-and-doduo-hacked-changes"
    },
    {
      "categories": [
        "food",
        "technology",
        "utility"
      ],
      "client_side": "required",
      "description": "A Create Mod Addon that adds different food items, mainly nuts.",
      "downloads": 848644,
      "followers": 250,
      "icon_url": "https://cdn.modrinth.com/data/6e2SlzR4/cd7fa892b619c7ebe5513e9eceb2fb54c4971766_96.webp",
      "id": "6e2SlzR4",
      "license_id": "MIT",
      "loaders": [
        "fabric",
        "forge",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "published": "2023-06-27T20:08:02.358123Z",
      "server_side": "required",
      "slug": "create-garnished",
      "status": "approved",
      "title": "Create: Garnished",
      "updated": "2026-09-21T02:10:25.792465Z",
      "url": "https://modrinth.com/mod/create-garnished"
    }
  ]
}

Get several projects

Get up to 100 Modrinth projects in one step, by slug or ID, with their downloads, followers, loaders, licence and last update. Slugs or IDs Modrinth doesn't have are listed rather than failing the step. No API key required.

Inputs

ProjectsprojectslistRequired
The projects' slugs, IDs or modrinth.com links, up to 100.

Outputs

countnumber
How many projects came back.
not_foundlist
The slugs or IDs asked for that Modrinth doesn't have.
projectslist
The projects found, in the order asked for.
Example output
{
  "count": 2,
  "not_found": [
    "no-such-project-zz"
  ],
  "projects": [
    {
      "categories": [
        "optimization"
      ],
      "client_side": "required",
      "description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
      "downloads": 251168597,
      "followers": 42017,
      "icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
      "id": "AANobbMI",
      "license_id": "LicenseRef-Polyform-Shield-1.0.0",
      "loaders": [
        "fabric",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "published": "2021-01-03T00:53:34.185936Z",
      "server_side": "unsupported",
      "slug": "sodium",
      "status": "approved",
      "title": "Sodium",
      "updated": "2026-10-15T17:51:44.107526Z",
      "url": "https://modrinth.com/mod/sodium"
    },
    {
      "categories": [
        "library"
      ],
      "client_side": "optional",
      "description": "Lightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.",
      "downloads": 285917544,
      "followers": 37150,
      "icon_url": "https://cdn.modrinth.com/data/P7dR8mSH/icon.png",
      "id": "P7dR8mSH",
      "license_id": "Apache-2.0",
      "loaders": [
        "fabric"
      ],
      "project_type": "mod",
      "published": "2021-01-22T11:04:41.419169Z",
      "server_side": "optional",
      "slug": "fabric-api",
      "status": "approved",
      "title": "Fabric API",
      "updated": "2026-10-20T16:26:07.911368Z",
      "url": "https://modrinth.com/mod/fabric-api"
    }
  ]
}

Get statistics

Get how many projects, versions, files and authors Modrinth holds, for tracking the platform's growth. No API key required.

Inputs

None.

Outputs

authorsnumber
How many people have published on Modrinth.
filesnumber
How many files those versions hold.
projectsnumber
How many projects Modrinth holds.
versionsnumber
How many versions they have published.
Example output
{
  "authors": 70582,
  "files": 1627281,
  "projects": 163601,
  "versions": 1500379
}

Identify files by hash

Find which project and version each mod file belongs to, from its SHA-1 or SHA-512 hash, up to 100 at a time. Files Modrinth doesn't know come back with 'found' set to false rather than failing the step. No API key required.

Inputs

File hasheshasheslistRequired
The SHA-1 or SHA-512 hash of each file, up to 100. Both kinds can be mixed: which is which is read from its length. Launchers and modpack files (modrinth.index.json) list these for every mod.

Outputs

countnumber
How many hashes were looked up.
fileslist
One answer per hash, in the order given.
found_countnumber
How many of them Modrinth knows.
not_found_countnumber
How many it doesn't.
Example output
{
  "count": 2,
  "files": [
    {
      "algorithm": "sha1",
      "date_published": "2026-08-28T20:55:02.424329Z",
      "download_url": "https://cdn.modrinth.com/data/AANobbMI/versions/SMxNOGZ6/sodium-fabric-0.8.13%2Bmc1.21.1.jar",
      "file_name": "sodium-fabric-0.8.13+mc1.21.1.jar",
      "found": true,
      "game_versions": [
        "1.21.1"
      ],
      "hash": "003c114c85ca88ef3362e018deb6aca0c682d6a1",
      "loaders": [
        "fabric"
      ],
      "project_id": "AANobbMI",
      "project_slug": "sodium",
      "project_title": "Sodium",
      "url": "https://modrinth.com/project/AANobbMI/version/SMxNOGZ6",
      "version_id": "SMxNOGZ6",
      "version_name": "Sodium 0.8.13 for Fabric 1.21.1",
      "version_number": "mc1.21.1-0.8.13-fabric",
      "version_type": "release"
    },
    {
      "algorithm": "sha1",
      "date_published": null,
      "download_url": null,
      "file_name": null,
      "found": false,
      "game_versions": [],
      "hash": "0000000000000000000000000000000000000000",
      "loaders": [],
      "project_id": null,
      "project_slug": null,
      "project_title": null,
      "url": null,
      "version_id": null,
      "version_name": null,
      "version_number": null,
      "version_type": null
    }
  ],
  "found_count": 1,
  "not_found_count": 1
}

List a project's team

List the people on a project's team with their roles, such as Owner or Maintainer. A project owned by an organization lists its own team only. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

Outputs

countnumber
How many members came back.
memberslist
The team, in the order the project shows it.
projecttext
The project asked about.
Example output
{
  "count": 2,
  "members": [
    {
      "accepted": true,
      "avatar_url": "https://avatars.githubusercontent.com/u/1939216?v=4",
      "bio": null,
      "role": "Member",
      "url": "https://modrinth.com/user/Player7457",
      "user_id": "iFMgB5Ib",
      "username": "Player7457"
    },
    {
      "accepted": true,
      "avatar_url": "https://avatars2.githubusercontent.com/u/4324090?v=4",
      "bio": null,
      "role": "Owner",
      "url": "https://modrinth.com/user/modmuss50",
      "user_id": "JZA4dW8o",
      "username": "modmuss50"
    }
  ],
  "project": "fabric-api"
}

List a project's versions

List a project's versions, newest first, with their files, download links, hashes, loaders, Minecraft versions and dependencies. Narrow by loader, Minecraft version, release channel, or to the versions the project features. No API key required.

Inputs

ProjectprojecttextRequired
The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
Loadersloaderslist
Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
Minecraft versionsgame_versionslist
Only versions for these Minecraft versions. Any one of them is enough. The list offers release versions; type a snapshot such as '26.4-snapshot-4' to use one. Leave empty for every Minecraft version.
Release channelversion_typetext
Only releases, betas or alphas. Leave empty for all three.One of: release, beta, alpha.
Featured onlyfeatured_onlytrue/false
Only the versions the project's authors feature on its page, usually the recommended one per Minecraft version.Default: false.
How many to returnlimitnumber
How many versions to return, newest first, up to 500.From 1 to 500. Default: 25.

Outputs

countnumber
How many versions came back.
more_availabletrue/false
Whether raising the limit would return more.
projecttext
The project asked about.
total_matchingnumber
How many versions match the filters altogether.
versionslist
Its versions, newest first.
Example output
{
  "count": 2,
  "more_available": true,
  "project": "fabric-api",
  "total_matching": 36,
  "versions": [
    {
      "date_published": "2026-09-01T16:40:04.373428Z",
      "dependencies": [],
      "download_url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/Mys3P7lK/fabric-api-0.116.17%2B1.21.1.jar",
      "downloads": 2975785,
      "file_name": "fabric-api-0.116.17+1.21.1.jar",
      "file_size": 2452735,
      "files": [
        {
          "file_name": "fabric-api-0.116.17+1.21.1.jar",
          "file_type": null,
          "primary": true,
          "sha1": "810b2b0195371a012906241d8b85a32a1d6de53c",
          "sha512": "98c478217da19181f0e4df3ea6c2da6bdbda271c7544a4aea048513a49b444f1ff5b71dc0df6303017c48e8ff69b7bb6af6179bdf0d0e09ab3c1ee08411857a8",
          "size": 2452735,
          "url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/Mys3P7lK/fabric-api-0.116.17%2B1.21.1.jar"
        }
      ],
      "game_versions": [
        "1.21.1"
      ],
      "id": "Mys3P7lK",
      "loaders": [
        "fabric"
      ],
      "name": "[1.21.1] Fabric API 0.116.17+1.21.1",
      "project_id": "P7dR8mSH",
      "sha1": "810b2b0195371a012906241d8b85a32a1d6de53c",
      "sha512": "98c478217da19181f0e4df3ea6c2da6bdbda271c7544a4aea048513a49b444f1ff5b71dc0df6303017c48e8ff69b7bb6af6179bdf0d0e09ab3c1ee08411857a8",
      "status": "listed",
      "url": "https://modrinth.com/project/P7dR8mSH/version/Mys3P7lK",
      "version_number": "0.116.17+1.21.1",
      "version_type": "release"
    },
    {
      "date_published": "2026-09-01T10:29:57.072338Z",
      "dependencies": [],
      "download_url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/fpB2VatZ/fabric-api-0.116.16%2B1.21.1.jar",
      "downloads": 26657,
      "file_name": "fabric-api-0.116.16+1.21.1.jar",
      "file_size": 2467467,
      "files": [
        {
          "file_name": "fabric-api-0.116.16+1.21.1.jar",
          "file_type": null,
          "primary": true,
          "sha1": "07fcbd957f45592ac3ac63161b0bf4f0b724c665",
          "sha512": "1ee763b538619b917b3bf02568dd2fb6c4ca3dc98e5554dc944e4524c316437946b00b6c1c4597ca86871f820b894c4b7b2b5701f7479e2dd057b0ea947886df",
          "size": 2467467,
          "url": "https://cdn.modrinth.com/data/P7dR8mSH/versions/fpB2VatZ/fabric-api-0.116.16%2B1.21.1.jar"
        }
      ],
      "game_versions": [
        "1.21.1"
      ],
      "id": "fpB2VatZ",
      "loaders": [
        "fabric"
      ],
      "name": "[1.21.1] Fabric API 0.116.16+1.21.1",
      "project_id": "P7dR8mSH",
      "sha1": "07fcbd957f45592ac3ac63161b0bf4f0b724c665",
      "sha512": "1ee763b538619b917b3bf02568dd2fb6c4ca3dc98e5554dc944e4524c316437946b00b6c1c4597ca86871f820b894c4b7b2b5701f7479e2dd057b0ea947886df",
      "status": "listed",
      "url": "https://modrinth.com/project/P7dR8mSH/version/fpB2VatZ",
      "version_number": "0.116.16+1.21.1",
      "version_type": "release"
    }
  ]
}

List a user's projects

List the projects a Modrinth user publishes, most downloaded first, with their downloads added up. No API key required.

Inputs

UserusertextRequired
A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.

Outputs

countnumber
How many projects came back.
projectslist
Their projects, most downloaded first.
total_downloadsnumber
Their projects' downloads added together.
usertext
The user asked about.
Example output
{
  "count": 2,
  "projects": [
    {
      "categories": [
        "optimization"
      ],
      "client_side": "required",
      "description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
      "downloads": 251168597,
      "followers": 42017,
      "icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
      "id": "AANobbMI",
      "license_id": "LicenseRef-Polyform-Shield-1.0.0",
      "loaders": [
        "fabric",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "published": "2021-01-03T00:53:34.185936Z",
      "server_side": "unsupported",
      "slug": "sodium",
      "status": "approved",
      "title": "Sodium",
      "updated": "2026-10-15T17:51:44.107526Z",
      "url": "https://modrinth.com/mod/sodium"
    },
    {
      "categories": [
        "optimization"
      ],
      "client_side": "optional",
      "description": "No-compromises game logic optimization mod, useful for both single-player games and multi-player servers.",
      "downloads": 140925772,
      "followers": 24033,
      "icon_url": "https://cdn.modrinth.com/data/gvQqBUqZ/bcc8686c13af0143adf4285d741256af824f70b7_96.webp",
      "id": "gvQqBUqZ",
      "license_id": "LGPL-3.0-only",
      "loaders": [
        "fabric",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "published": "2021-01-03T00:56:52.292581Z",
      "server_side": "optional",
      "slug": "lithium",
      "status": "approved",
      "title": "Lithium",
      "updated": "2026-09-28T03:43:35.615649Z",
      "url": "https://modrinth.com/mod/lithium"
    }
  ],
  "total_downloads": 392094369,
  "user": "jellysquid3"
}

List categories

List the categories projects are filed under on Modrinth, such as Optimization, Worldgen or 16x, with the project type each belongs to. No API key required.

Inputs

Project typeproject_typetext
Only those used by this type of project. Leave empty for all.One of: mod (Mods), modpack (Modpacks), resourcepack (Resource packs), shader (Shaders), plugin (Plugins), datapack (Data packs), minecraft_java_server (Servers).

Outputs

categorieslist
The categories, grouped by project type.
countnumber
How many categories came back.
project_typetext
The project type they were narrowed to, if any.
Example output
{
  "categories": [
    {
      "group": "Categories",
      "label": "Cartoon",
      "name": "cartoon",
      "project_type": "shader"
    },
    {
      "group": "Categories",
      "label": "Cursed",
      "name": "cursed",
      "project_type": "shader"
    },
    {
      "group": "Categories",
      "label": "Fantasy",
      "name": "fantasy",
      "project_type": "shader"
    }
  ],
  "count": 3,
  "project_type": "shader"
}

List loaders

List the loaders and platforms Modrinth knows, such as Fabric, NeoForge, Paper or Iris, with the project types each is used for. No API key required.

Inputs

Project typeproject_typetext
Only those used by this type of project. Leave empty for all.One of: mod (Mods), modpack (Modpacks), resourcepack (Resource packs), shader (Shaders), plugin (Plugins), datapack (Data packs), minecraft_java_server (Servers).

Outputs

countnumber
How many loaders came back.
loaderslist
The loaders, by name.
project_typetext
The project type they were narrowed to, if any.
Example output
{
  "count": 4,
  "loaders": [
    {
      "label": "Fabric",
      "name": "fabric",
      "project_types": [
        "mod",
        "modpack"
      ]
    },
    {
      "label": "Forge",
      "name": "forge",
      "project_types": [
        "mod",
        "modpack"
      ]
    },
    {
      "label": "NeoForge",
      "name": "neoforge",
      "project_types": [
        "mod",
        "modpack"
      ]
    },
    {
      "label": "Quilt",
      "name": "quilt",
      "project_types": [
        "mod",
        "modpack"
      ]
    }
  ],
  "project_type": "modpack"
}

List Minecraft versions

List Minecraft versions, newest first, with the date each came out: releases by default, or snapshots, old betas and alphas. The newest comes back on its own too, so a workflow can notice a new Minecraft release. No API key required.

Inputs

Which versionsversion_typetext
Releases by default.One of: release (Releases), snapshot (Snapshots), beta (Old betas), alpha (Old alphas), all (All of them). Default: release.

Outputs

countnumber
How many versions came back.
game_versionslist
The Minecraft versions, newest first.
latesttext
The newest version listed.
version_typetext
Which kind of version was listed, or 'all'.
Example output
{
  "count": 3,
  "game_versions": [
    {
      "release_date": "2026-09-15T11:23:02Z",
      "version": "26.3",
      "version_type": "release"
    },
    {
      "release_date": "2026-06-16T12:03:33Z",
      "version": "26.2",
      "version_type": "release"
    },
    {
      "release_date": "2026-04-09T10:12:23Z",
      "version": "26.1.2",
      "version_type": "release"
    }
  ],
  "latest": "26.3",
  "version_type": "release"
}

Search projects

Find Minecraft mods, modpacks, resource packs, shaders, plugins, data packs and servers on Modrinth by name or words, narrowed by type, category, loader, Minecraft version, whether it runs in the player's game or on a server, and open source. Sort by best match, downloads, followers, newest or recently updated. Each result comes with its downloads, loaders, licence and the ID of its newest version. No API key required.

Inputs

Search textquerytext
Words to look for in project names and summaries. Leave empty to browse with the filters alone.
Project typeproject_typetext
Only this type of project. Leave empty for every type.One of: mod (Mods), modpack (Modpacks), resourcepack (Resource packs), shader (Shaders), plugin (Plugins), datapack (Data packs), minecraft_java_server (Servers).
Categoriescategorieslist
Only projects filed under every one of these categories, such as Optimization or Worldgen. Leave empty for any.
Loadersloaderslist
Only projects for any of these loaders, such as Fabric, NeoForge or Paper. Leave empty for every loader.
Minecraft versionsgame_versionslist
Only projects with a file for any of these Minecraft versions. The list offers release versions; type a snapshot to use one. Leave empty for every version.
Where it runsenvironmenttext
Only projects that run in the player's game, on a server, or only in one of the two. Leave empty for all.One of: client (Works in the player's game), server (Works on a server), client_only (Only in the player's game), server_only (Only on a server).
Open source onlyopen_source_onlytrue/false
Only projects published under an open source licence.Default: false.
Sort bysorttext
The order of the results. Best match by default.One of: relevance (Best match), downloads (Most downloaded), follows (Most followed), newest, updated (Recently updated). Default: relevance.
How many to returnlimitnumber
How many projects to return, up to 100.From 1 to 100. Default: 10.
Skipoffsetnumber
How many matching projects to skip, to read the next page: with 10 a page, 10 reads the second page.At least 0. Default: 0.

Outputs

countnumber
How many projects came back.
more_availabletrue/false
Whether a further page would return more.
offsetnumber
How many matching projects were skipped.
projectslist
The projects found, in the order asked for.
sorttext
How the results were ordered.
total_hitsnumber
How many projects match altogether.
Example output
{
  "count": 2,
  "more_available": true,
  "offset": 0,
  "projects": [
    {
      "author": "jellysquid3",
      "categories": [
        "optimization"
      ],
      "client_side": "required",
      "created": "2021-01-03T00:53:34.185936+00:00",
      "description": "A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.",
      "downloads": 250585660,
      "followers": 41999,
      "icon_url": "https://cdn.modrinth.com/data/AANobbMI/295862f4724dc3f78df3447ad6072b2dcd3ef0c9_96.webp",
      "id": "AANobbMI",
      "latest_version_id": "SMxNOGZ6",
      "license_id": "LicenseRef-Polyform-Shield-1.0.0",
      "loaders": [
        "fabric",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "project_types": [
        "mod"
      ],
      "server_side": "unsupported",
      "slug": "sodium",
      "title": "Sodium",
      "updated": "2026-10-15T17:51:36.063140+00:00",
      "url": "https://modrinth.com/mod/sodium"
    },
    {
      "author": "FlashyReese",
      "categories": [
        "cursed",
        "optimization",
        "utility"
      ],
      "client_side": "required",
      "created": "2021-02-17T04:37:04.928784+00:00",
      "description": "A Sodium addon that adds features that shouldn't be in Sodium.",
      "downloads": 105327434,
      "followers": 13746,
      "icon_url": "https://cdn.modrinth.com/data/PtjYWJkn/0df4fb22a11e1dcb5e83cb0aadd275b571aca7a9_96.webp",
      "id": "PtjYWJkn",
      "latest_version_id": "YEWu6red",
      "license_id": "LGPL-3.0-only",
      "loaders": [
        "fabric",
        "neoforge",
        "quilt"
      ],
      "project_type": "mod",
      "project_types": [
        "mod"
      ],
      "server_side": "unsupported",
      "slug": "sodium-extra",
      "title": "Sodium Extra",
      "updated": "2026-09-16T02:48:16.702643+00:00",
      "url": "https://modrinth.com/mod/sodium-extra"
    }
  ],
  "sort": "downloads",
  "total_hits": 25
}

On this page