🎮 Modrinth Mods Scraper

🚀 Export the Modrinth catalogue in seconds. Search 30,000+ Minecraft mods, modpacks, shaders, resource packs, data packs, and plugins by category, mod loader, or Minecraft version, and pull downloads, follows, license, and gallery data in one run. No sign-up, no token plumbing, no manual paging.

🕒 Last updated: 2026-05-15 · 📊 26 fields per record · 🎮 30,000+ projects · 🛠️ 6 project types · 🔁 Live per run

The Modrinth Mods Scraper queries the official Modrinth catalogue and returns 26 fields per project, including title, slug, project type, author, description, categories, supported mod loaders, supported Minecraft versions, license, downloads, follows, gallery URLs, brand colour, and creation/update timestamps. Modrinth is the leading open-source Minecraft modding platform, hosting work from independent creators and well-known modding studios alike.

The catalogue spans 30,000+ projects across 6 project types (mods, modpacks, resource packs, shaders, data packs, plugins), 60+ category tags, and every modern mod loader from Fabric and Forge to NeoForge, Quilt, Paper, Bukkit, and Spigot. This Actor streams matching records as CSV, Excel, JSON, or XML in under five minutes. Filtering runs server-side, so you skip pagination and facet wrangling entirely.

🎯 Target Audience	💡 Primary Use Cases
Modpack creators, server admins, modding studios, content creators, marketplace operators, data researchers, modding-tool builders	Modpack curation, version-compatibility checks, trending-mod tracking, server-tooling discovery, license audits, creator analytics

---

📋 What the Modrinth Mods Scraper does

Five filtering workflows in a single run:

• 🔍 Keyword search. Free-text query across project titles, slugs, and descriptions.
• 📂 Project-type filter. Restrict to mods, modpacks, resource packs, shaders, data packs, or plugins.
• 🧩 Category filter. OR-combine 60+ tags like optimization, adventure, magic, library, pve, worldgen, pbr, shaders.
• 🛠️ Mod-loader filter. Pick Fabric, Forge, NeoForge, Quilt, Paper, Bukkit, Spigot, Sponge, Velocity, and more.
• 🎯 Minecraft version filter. Scope to one or more game versions like 1.21.1, 1.20.4, 1.19.2.

Sort the result by relevance, downloads, follows, newest, or recently updated. Each record includes the project ID, slug, author and organization, downloads, follows, supported game versions, license, gallery URLs, featured gallery image, brand colour, and timestamps.

💡 Why it matters: modpack curators and server admins burn hours cross-referencing loader compatibility, Minecraft versions, and trending downloads across thousands of projects. This Actor flattens that into a single dataset so you can plan, audit, or visualise an entire modding ecosystem in one pull.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Modrinth dataset.

---

⚙️ Input

Input	Type	Default	Behavior
query	string	"fabric"	Free-text search across titles, slugs and descriptions. Empty = browse the full catalogue.
projectType	string	""	One of 6 Modrinth project types. Empty = any type.
index	string	"relevance"	Sort by relevance, downloads, follows, newest, or updated.
categories	string[]	[]	OR-combined list of category slugs (60+ tags supported).
loaders	string[]	[]	OR-combined list of mod loaders (Fabric, Forge, NeoForge, Quilt, Paper, etc.).
gameVersions	string[]	[]	OR-combined list of supported Minecraft versions like "1.21.1".
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.

Example: top 50 Fabric optimization mods for Minecraft 1.21.1.

{
    "maxItems": 50,
    "query": "",
    "projectType": "mod",
    "index": "downloads",
    "categories": ["optimization"],
    "loaders": ["fabric"],
    "gameVersions": ["1.21.1"]
}

Example: most-followed shader packs.

{
    "maxItems": 100,
    "query": "",
    "projectType": "shader",
    "index": "follows"
}

⚠️ Good to Know: download and follow counts reflect the values published by the catalogue and may lag the live counters by a few minutes. Some projects expose latestVersion only when their author has uploaded a primary file. Server-pack-only projects can show serverSide: required and clientSide: unsupported.

---

📊 Output

Each Modrinth project record contains 26 fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🖼️ iconUrl	string | null	"https://cdn.modrinth.com/data/AANobbMI/icon.png"
📌 title	string	"Sodium"
🏷️ slug	string	"sodium"
🔗 url	string	"https://modrinth.com/mod/sodium"
🆔 projectId	string	"AANobbMI"
📂 projectType	string	"mod"
👤 author	string	"jellysquid3"
🆔 authorId	string	"uhPSqlnd"
🏢 organization	string | null	"CaffeineMC"
🆔 organizationId	string | null	"caffeinemc"
📝 description	string	"The fastest and most compatible rendering optimization mod for Minecraft."
🏷️ categories	string[]	["fabric","optimization"]
🏷️ displayCategories	string[]	["optimization"]
💻 clientSide	string	"required"
💻 serverSide	string	"unsupported"
📜 license	string	"LGPL-3.0-only"
📈 downloads	number	28150412
📈 follows	number	15028
🏷️ latestVersion	string | null	"1.21.1"
🔢 gameVersionsSupportedCount	number	47
📦 gameVersionsSupported	string[]	["1.16.5","...","1.21.1"]
📦 gallery	string[]	["https://cdn.modrinth.com/data/AANobbMI/images/...png"]
🖼️ featuredGallery	string | null	"https://cdn.modrinth.com/data/AANobbMI/images/featured.png"
🎨 color	number | null	2237017
📅 dateCreated	ISO 8601	"2021-01-04T11:13:55Z"
🕒 dateModified	ISO 8601	"2026-04-21T18:02:44Z"
🕒 scrapedAt	ISO 8601	"2026-05-15T00:00:00.000Z"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🎮	Catalogue-wide reach. 30,000+ mods, modpacks, shaders, resource packs, data packs, and plugins.
🎯	5-axis filtering. Query, project type, categories, mod loaders, and Minecraft versions combine freely.
🧾	26 fields per record. Identity, ownership, popularity, version coverage, gallery, and timestamps.
🛠️	Loader-aware. Fabric, Forge, NeoForge, Quilt, Paper, Bukkit, Spigot, Sponge, Velocity, and more.
⚡	Fast. 10 projects in under 5 seconds, 10,000 records in under 90 seconds.
🔁	Always fresh. Every run hits the live catalogue, so download and follow counts reflect run time.
🚫	No authentication. Public catalogue access. No login, no token.

📊 Reliable project metadata is the foundation of every modpack launch, server-side curation, and modding analytics dashboard in the Minecraft community.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ Modrinth Mods Scraper (this Actor)	$5 free credit, then pay-per-use	30,000+ projects	Live per run	query, type, categories, loaders, versions	⚡ 2 min
In-house Modrinth client	Free + dev time	Full	Per request	Custom code	🐢 Days
Third-party launcher exports	Free	Partial	Per launcher release	Loader-specific	🕒 Variable
Manual catalogue browsing	Free	One project at a time	Live	UI only	🕒 Tedious

Pick this Actor when you want broad catalogue coverage, server-side filters, and zero pipeline maintenance.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the Modrinth Mods Scraper page on the Apify Store.
3. 🎯 Set input. Enter a query (or leave blank), pick a project type and categories, and set maxItems.
4. 🚀 Run it. Click Start and let the Actor pull your matching projects.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

📦 Modpack Curation Trending optimisation mods for performance modpacks Magic + adventure category bundles for themed packs Loader-pinned shortlists for Fabric or NeoForge releases License-clean lists for distributable packs	🖥️ Server Tooling & Hosting Plugin discovery for Paper, Bukkit, and Spigot servers Server-side mod inventories for hosting providers Network add-ons for Velocity and BungeeCord proxies Compatibility audits across player Minecraft versions
🎬 Content & Community Trending-mod feeds for YouTube and Twitch creators Newest-shader showcases for visual content Creator profiles by author and organisation Category-driven mod-of-the-week roundups	📊 Modding Analytics Adoption charts by loader and Minecraft version License compliance dashboards across thousands of projects Download and follow correlation studies Brand-colour palettes for marketing material

---

🔌 Automating Modrinth Mods Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Hourly, daily, or weekly refreshes keep modpack dashboards and creator analytics in sync.

---

🌟 Beyond business use cases

The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Open-source community studies in the modding ecosystem Long-tail content analyses across category and loader Game-modding adoption research with longitudinal data Coursework on community catalogues and metadata design	🎨 Personal and creative Indie modpack catalogues and personal launchers Hobbyist trackers for favourite shader packs Visualisations of the Minecraft modding landscape Side projects exploring gallery and brand-colour data
🤝 Non-profit and civic Community spotlights for solo Minecraft creators Inclusive modpacks for educational Minecraft programs Open showcases for accessibility-focused mods Sponsorship targeting based on download impact	🧪 Experimentation Train classifiers that recommend mods from prompts Validate modpack-launcher product hypotheses with real data Prototype agent pipelines that build packs from a theme Test modpack-search UX with live catalogue data

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a project type, optionally add categories, loaders, and Minecraft versions, then click Start. The Actor applies the filters server-side and returns one structured record per matching project. No browser automation, no captchas, no setup.

📏 How accurate are the download and follow counts?

Numbers reflect the values published by the catalogue. They can lag the live counters by a few minutes during heavy publishing periods. Every run pulls the freshest figures available at run time.

🔁 How often is the catalogue refreshed?

Modrinth updates continuously as creators publish new versions and projects. Every run of this Actor pulls the latest catalogue state.

🛠️ Which mod loaders are supported?

Fabric, Forge, NeoForge, Quilt, Iris, OptiFine, Paper, Bukkit, Spigot, Sponge, Velocity, BungeeCord, Waterfall, Folia, Purpur, Liteloader, Rift, Babric, Legacy Fabric, Minecraft (vanilla), and more.

🎯 Can I scope to a specific Minecraft version?

Yes. Pass any combination of game-version strings like "1.21.1", "1.20.4", or "1.19.2". Versions are OR-combined so you get every project supporting at least one of them.

📂 Can I include resource packs and shaders?

Yes. Set projectType to resourcepack, shader, datapack, or plugin. Leave it empty to include every project type.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor on any cron interval (hourly, daily, weekly) and keep a downstream database in sync.

⚖️ Is this data legal to use?

Project metadata in the catalogue is publicly browsable. Honour each creator's licence when redistributing the actual mod files (the Actor returns metadata only, not the binaries themselves).

💼 Can I use this data commercially?

Listing metadata is generally fine for analytics and discovery use. Always honour each project's own licence when bundling or redistributing the actual artefacts.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you scheduling, higher concurrency, and larger datasets.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

Modrinth Mods Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• Airbyte - Pipe project data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh project data into your modpack pipeline, or alert your team in Slack on new releases of watched projects.

---

🔗 Recommended Actors

• 📦 NuGet Packages Scraper - .NET package catalogue and download history
• 🦀 Crates.io Scraper - Rust crate metadata and downloads
• 📦 Hex.pm Elixir Packages Scraper - Elixir/Erlang package catalogue
• ☁️ cdnjs Libraries Scraper - Front-end JS and CSS libraries hosted on cdnjs
• 📦 Docker Hub Scraper - Container image metadata and pulls

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Modrinth, Mojang, Microsoft, or any modding studio. Minecraft is a trademark of Mojang Synergies AB. All trademarks mentioned are the property of their respective owners. Only publicly available project metadata is collected.