Modrinth Scraper

Scrape Modrinth — the largest open-source Minecraft mod, plugin, and modpack registry with over 50,000 projects and billions of downloads. Search by keyword, browse by category, or filter by mod loader to find the most popular and recently updated projects.

Features

• Three search modes: keyword search, category browsing, or loader-specific filtering
• All project types: mods, plugins, datapacks, shaders, resource packs, and modpacks
• Flexible sorting: by relevance, downloads, follows, newest, or recently updated
• Rich metadata: download counts, follower counts, game version compatibility, mod loader support, license info, and direct project URLs
• No authentication required: uses the public Modrinth REST API

Use Cases

• Track the most popular Minecraft mods in specific categories
• Monitor new releases for specific mod loaders (Fabric, Forge, NeoForge)
• Build Minecraft modding news feeds and recommendation systems
• Research mod adoption trends and download statistics
• Find compatible mods for specific Minecraft versions

Input

Field	Type	Description	Default
mode	Select	Search mode: search, byCategory, or byLoader	search
keyword	Text	Search keyword (mode=search)	magic
projectType	Select	Type: mod, plugin, datapack, shader, resourcepack, modpack	mod
category	Select	Category filter (mode=byCategory): magic, technology, utility, optimization, etc.	magic
loader	Select	Mod loader filter (mode=byLoader): fabric, forge, neoforge, quilt, etc.	fabric
sortBy	Select	Sort order: relevance, downloads, follows, newest, updated	relevance
maxItems	Integer	Maximum number of projects to return (1–500)	20

Output

Each record contains:

Field	Type	Description
projectId	String	Unique Modrinth project ID
slug	String	URL-friendly project slug
title	String	Project display name
description	String	Short project description
author	String	Project author username
projectType	String	Type: mod, plugin, modpack, etc.
categories	Array	Project category tags
loaders	Array	Supported mod loaders (Fabric, Forge, etc.)
gameVersions	Array	Supported Minecraft versions (up to 10)
downloads	Integer	Total all-time downloads
follows	Integer	Number of followers
latestVersion	String	Latest release version
license	String	Open source license identifier
dateCreated	String	ISO 8601 creation timestamp
dateModified	String	ISO 8601 last update timestamp
iconUrl	String	Project icon image URL
projectUrl	String	Direct link to the Modrinth project page
scrapedAt	String	ISO 8601 scrape timestamp

Example Output

{
  "projectId": "9hx3AbJM",
  "slug": "easy-magic",
  "title": "Easy Magic",
  "description": "Enchanting tables as they always should have been!",
  "author": "Fuzs",
  "projectType": "mod",
  "categories": ["magic", "utility"],
  "loaders": ["fabric", "forge", "neoforge"],
  "gameVersions": ["1.20.1", "1.20", "1.19.4"],
  "downloads": 2500000,
  "follows": 8500,
  "latestVersion": "21.3.4",
  "license": "MIT",
  "dateCreated": "2021-07-10T12:00:00Z",
  "dateModified": "2026-05-15T08:00:00Z",
  "iconUrl": "https://cdn.modrinth.com/data/9hx3AbJM/icon.png",
  "projectUrl": "https://modrinth.com/mod/easy-magic",
  "scrapedAt": "2026-06-04T15:30:00.000000+00:00"
}

FAQs

Does this require an API key? No. The Modrinth API (api.modrinth.com/v2) is fully public and requires no authentication.

What's the difference between categories and loaders? Categories describe the mod's content (magic, technology, optimization). Loaders indicate the Minecraft modding framework it supports (Fabric, Forge, NeoForge).

How do I find mods for a specific Minecraft version? Use keyword search and check the gameVersions field in the output. Future versions of this actor will add explicit version filtering.

Are modpacks included? Yes. Set projectType to modpack to search modpacks specifically.

How many downloads are typical for popular mods? Top mods have hundreds of millions of downloads. The sortBy=downloads option returns the most downloaded projects first.