# Modrinth

> 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.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/modrinth

## Actions

### 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**

- Project (`project`, text, required): The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

**Outputs**

- `found` (true/false): Whether a project has that slug or ID.
- `id` (text): The project's ID, when it exists.
- `searched_for` (text): The slug or ID that was checked.
- `url` (text): The project's page on modrinth.com, when it exists.

**Example output**

```json
{
  "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 hashes (`hashes`, list, required): 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.
- Loaders (`loaders`, list): Only updates for these loaders, such as Fabric. Leave empty for any loader, which may offer a version for a different loader.
- Minecraft versions (`game_versions`, list): Only updates for these Minecraft versions. Leave empty to allow any, including newer Minecraft versions.
- Release channels (`version_types`, list): 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**

- `count` (number): How many hashes were checked.
- `files` (list): One answer per hash, in the order given.
- `not_found_count` (number): How many hashes Modrinth doesn't know.
- `update_count` (number): How many files have a newer version.

**Example output**

```json
{
  "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**

- Project (`project`, text, required): The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

**Outputs**

- `body` (text): The project's full description page, written in Markdown.
- `categories` (list): The categories it is filed under, such as 'optimization'.
- `client_side` (text): Whether players need it installed: 'required', 'optional' or 'unsupported' (or 'unknown'). A mod that is 'unsupported' on the server only needs installing by players.
- `description` (text): The project's one-line summary.
- `discord_url` (text): Its Discord invite, when given.
- `donation_urls` (list): Where to support its authors.
- `downloads` (number): How many times its files have been downloaded.
- `followers` (number): How many Modrinth users follow it.
- `gallery` (list): Its gallery images.
- `game_versions` (list): Every Minecraft version it has a file for, oldest first.
- `icon_url` (text): The address of its icon image.
- `id` (text): The project's ID, such as 'AANobbMI'. It never changes.
- `issues_url` (text): Where to report bugs, when given.
- `license_id` (text): Its licence's SPDX ID, such as 'MIT', or a 'LicenseRef-' ID for a licence of its own.
- `license_name` (text): Its licence's full name, or its ID when Modrinth has none.
- `license_url` (text): A link to its licence text, when the project gives one.
- `loaders` (list): The loaders it runs on, such as 'fabric' or 'neoforge'.
- `organization_id` (text): The ID of the organization that owns it, when one does.
- `project_type` (text): What it is: mod, modpack, resourcepack, shader, plugin, datapack or minecraft_java_server.
- `published` (text): When it was first published, as an ISO 8601 date and time.
- `server_side` (text): 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.
- `slug` (text): The project's slug, the readable name in its address, such as 'sodium'. Every action that takes a project accepts it.
- `source_url` (text): Where its source code is, when given.
- `status` (text): Its status on Modrinth, normally 'approved'.
- `team_id` (text): The ID of the team that maintains it.
- `title` (text): The project's name, such as 'Sodium'.
- `updated` (text): When it last changed, as an ISO 8601 date and time.
- `url` (text): Its page on modrinth.com.
- `wiki_url` (text): Its wiki or documentation, when given.

**Example output**

```json
{
  "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**

- Project (`project`, text, required): The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
- Loaders (`loaders`, list): Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
- Minecraft versions (`game_versions`, list): 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**

- `count` (number): How many projects are named.
- `dependencies` (list): Each project its versions name, required ones first.
- `external_files` (list): Files from outside Modrinth that versions name.
- `project` (text): The project whose versions were read.
- `required_count` (number): How many of them are required.
- `versions_checked` (number): How many of its versions were read: the ones matching the filters.

**Example output**

```json
{
  "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**

- User (`user`, text, required): A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.

**Outputs**

- `avatar_url` (text): The address of their profile picture.
- `bio` (text): What they wrote about themselves.
- `created` (text): When they joined, as an ISO 8601 date and time.
- `id` (text): The user's ID, such as 'TEZXhE2U'.
- `name` (text): The display name they chose, when they set one.
- `role` (text): Their role on Modrinth: developer, moderator or admin.
- `url` (text): Their profile page on modrinth.com.
- `username` (text): Their username, such as 'jellysquid3'.

**Example output**

```json
{
  "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 ID (`version_id`, text, required): The version's ID, such as 'SMxNOGZ6', as 'List a project's versions' or a search's newest version ID gives it.

**Outputs**

- `changelog` (text): What changed in this version, written in Markdown.
- `date_published` (text): When it was published, as an ISO 8601 date and time.
- `dependencies` (list): What this version needs, or refuses to run with.
- `download_url` (text): The address to download its main file from.
- `downloads` (number): How many times it has been downloaded.
- `file_name` (text): Its main file's name.
- `file_size` (number): Its main file's size in bytes.
- `files` (list): Every file in the version, the main one included.
- `game_versions` (list): The Minecraft versions it works with.
- `id` (text): The version's ID, such as 'SMxNOGZ6'.
- `loaders` (list): The loaders it works with, such as 'fabric'.
- `name` (text): The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
- `project_id` (text): The ID of the project it belongs to.
- `sha1` (text): Its main file's SHA-1 hash.
- `sha512` (text): Its main file's SHA-512 hash.
- `status` (text): Its status, normally 'listed'.
- `url` (text): The version's page on modrinth.com.
- `version_number` (text): Its version number, such as 'mc1.21.1-0.8.13-fabric'.
- `version_type` (text): Its release channel: release, beta or alpha.

**Example output**

```json
{
  "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**

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

**Outputs**

- `changelog` (text): What changed in this version, written in Markdown.
- `date_published` (text): When it was published, as an ISO 8601 date and time.
- `dependencies` (list): What this version needs, or refuses to run with.
- `download_url` (text): The address to download its main file from.
- `downloads` (number): How many times it has been downloaded.
- `file_name` (text): Its main file's name.
- `file_size` (number): Its main file's size in bytes.
- `files` (list): Every file in the version, the main one included.
- `game_versions` (list): The Minecraft versions it works with.
- `id` (text): The version's ID, such as 'SMxNOGZ6'.
- `loaders` (list): The loaders it works with, such as 'fabric'.
- `name` (text): The version's title, such as 'Sodium 0.8.13 for Fabric 1.21.1'.
- `project_id` (text): The ID of the project it belongs to.
- `sha1` (text): Its main file's SHA-1 hash.
- `sha512` (text): Its main file's SHA-512 hash.
- `status` (text): Its status, normally 'listed'.
- `url` (text): The version's page on modrinth.com.
- `version_number` (text): Its version number, such as 'mc1.21.1-0.8.13-fabric'.
- `version_type` (text): Its release channel: release, beta or alpha.

**Example output**

```json
{
  "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**

- Licence (`license_id`, text, required): The licence, as a project's licence ID gives it, such as 'MIT' or 'Apache-2.0'.

**Outputs**

- `body` (text): The licence's full text.
- `id` (text): The licence's SPDX ID.
- `title` (text): The licence's full name.

**Example output**

```json
{
  "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 many (`count`, number): How many projects to pick, up to 100. From 1 to 100. Default: `10`.

**Outputs**

- `count` (number): How many projects came back.
- `projects` (list): The projects Modrinth picked.

**Example output**

```json
{
  "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**

- Projects (`projects`, list, required): The projects' slugs, IDs or modrinth.com links, up to 100.

**Outputs**

- `count` (number): How many projects came back.
- `not_found` (list): The slugs or IDs asked for that Modrinth doesn't have.
- `projects` (list): The projects found, in the order asked for.

**Example output**

```json
{
  "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**

- `authors` (number): How many people have published on Modrinth.
- `files` (number): How many files those versions hold.
- `projects` (number): How many projects Modrinth holds.
- `versions` (number): How many versions they have published.

**Example output**

```json
{
  "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 hashes (`hashes`, list, required): 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**

- `count` (number): How many hashes were looked up.
- `files` (list): One answer per hash, in the order given.
- `found_count` (number): How many of them Modrinth knows.
- `not_found_count` (number): How many it doesn't.

**Example output**

```json
{
  "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**

- Project (`project`, text, required): The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.

**Outputs**

- `count` (number): How many members came back.
- `members` (list): The team, in the order the project shows it.
- `project` (text): The project asked about.

**Example output**

```json
{
  "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**

- Project (`project`, text, required): The project's slug (the name in its address, such as 'sodium'), its ID (such as 'AANobbMI'), or its modrinth.com link.
- Loaders (`loaders`, list): Only versions for these loaders, such as Fabric or NeoForge. Any one of them is enough. Leave empty for every loader.
- Minecraft versions (`game_versions`, list): 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 channel (`version_type`, text): Only releases, betas or alphas. Leave empty for all three. One of: `release`, `beta`, `alpha`.
- Featured only (`featured_only`, true/false): Only the versions the project's authors feature on its page, usually the recommended one per Minecraft version. Default: `false`.
- How many to return (`limit`, number): How many versions to return, newest first, up to 500. From 1 to 500. Default: `25`.

**Outputs**

- `count` (number): How many versions came back.
- `more_available` (true/false): Whether raising the limit would return more.
- `project` (text): The project asked about.
- `total_matching` (number): How many versions match the filters altogether.
- `versions` (list): Its versions, newest first.

**Example output**

```json
{
  "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**

- User (`user`, text, required): A Modrinth username (such as 'jellysquid3'), user ID, or profile link. 'List a project's team' gives the usernames behind a project.

**Outputs**

- `count` (number): How many projects came back.
- `projects` (list): Their projects, most downloaded first.
- `total_downloads` (number): Their projects' downloads added together.
- `user` (text): The user asked about.

**Example output**

```json
{
  "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 type (`project_type`, text): 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**

- `categories` (list): The categories, grouped by project type.
- `count` (number): How many categories came back.
- `project_type` (text): The project type they were narrowed to, if any.

**Example output**

```json
{
  "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 type (`project_type`, text): 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**

- `count` (number): How many loaders came back.
- `loaders` (list): The loaders, by name.
- `project_type` (text): The project type they were narrowed to, if any.

**Example output**

```json
{
  "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 versions (`version_type`, text): Releases by default. One of: `release` (Releases), `snapshot` (Snapshots), `beta` (Old betas), `alpha` (Old alphas), `all` (All of them). Default: `release`.

**Outputs**

- `count` (number): How many versions came back.
- `game_versions` (list): The Minecraft versions, newest first.
- `latest` (text): The newest version listed.
- `version_type` (text): Which kind of version was listed, or 'all'.

**Example output**

```json
{
  "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 text (`query`, text): Words to look for in project names and summaries. Leave empty to browse with the filters alone.
- Project type (`project_type`, text): 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).
- Categories (`categories`, list): Only projects filed under every one of these categories, such as Optimization or Worldgen. Leave empty for any.
- Loaders (`loaders`, list): Only projects for any of these loaders, such as Fabric, NeoForge or Paper. Leave empty for every loader.
- Minecraft versions (`game_versions`, list): 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 runs (`environment`, text): 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 only (`open_source_only`, true/false): Only projects published under an open source licence. Default: `false`.
- Sort by (`sort`, text): 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 return (`limit`, number): How many projects to return, up to 100. From 1 to 100. Default: `10`.
- Skip (`offset`, number): 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**

- `count` (number): How many projects came back.
- `more_available` (true/false): Whether a further page would return more.
- `offset` (number): How many matching projects were skipped.
- `projects` (list): The projects found, in the order asked for.
- `sort` (text): How the results were ordered.
- `total_hits` (number): How many projects match altogether.

**Example output**

```json
{
  "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
}
```
