ParseForge
Modrinth Mods Scraper
parseforge/modrinth-mods-scraper
Developer toolsBusinessAutomation
Scrapes Modrinth mods by search query, category, loader, or Minecraft version. Returns each mod as a flat row with downloads, follows, description, author, and compatibility.
- Total users
- 7
- Monthly active
- 0
- Total runs
- 123
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
Modrinth Mods Scraper
Scrape Modrinth mods by search query, category, loader, or Minecraft version, up to a million per run. Every mod comes with its downloads, follows, description, author, and compatibility. No login or API key. Export to CSV, JSON, Excel, or XML.
Modrinth's official API needs an API key and rate-limits you. This reads the public mod registry directly, filtered by search query, category, loader, or game version, and returns each match in one fixed schema. Get Modrinth mods data without writing a single line of code.
| Who uses it | What they scrape Modrinth for |
|---|---|
| Modpack developers | Which mods are compatible with a specific loader and Minecraft version |
| Market researchers | Which mod categories are growing fastest by download count |
| Server administrators | Which optimization mods support the server's Minecraft version |
| Content creators | Which new mods are trending for a video or stream |
What it does
This Actor collects Modrinth mods by search query, category, loader, or Minecraft version, and returns each one as a flat row.
- 🔎 Search query: free-text search across mod titles, descriptions, and slugs, e.g. "sodium", "jei", "create".
- 🧩 Category filter: adventure, cursed, decoration, economy, equipment, food, game mechanics, library, magic, management, minigame, mobs, optimization, social, storage, technology, transportation, utility, worldgen.
- 🔧 Loader filter: Fabric, Forge, NeoForge, Quilt, and 20 more loaders, combined with OR.
- 🕹️ Game version filter: any Minecraft release from 1.0 to 26.1.2, combined with OR.
- 📊 Sorting: relevance, downloads, follows, newest, or recently updated.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Modrinth data
📦 Build a modpack.
A modpack developer filters by loader and Minecraft version to get a list of compatible mods with download counts and descriptions.
📈 Track mod trends.
A market researcher scrapes all mods in a category sorted by downloads to see which are gaining traction.
🖥️ Optimize a server.
A server administrator searches for optimization mods and filters by the server's game version to find performance improvements.
🎮 Find content ideas.
A content creator sorts by newest to discover recently updated mods worth featuring.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads the public Modrinth registry directly, no registration or rate limits |
| Fixed schema | Every mod returns the same flat fields, ready for analysis |
| Flexible filters | Combine search, category, loader, and version to narrow results |
| Scalable | Up to 1,000,000 mods per run for paid users |
How it compares
This Actor offers the same core Modrinth scraping as the competitors below, with a focus on flexible filtering and a fixed schema.
| Feature | ParseForge | Modrinth Scraper | Modrinth Scraper |
|---|---|---|---|
| Search by keyword | Yes | Yes | Yes |
| Filter by category | Yes | Yes | Yes |
| Filter by loader | Yes | Yes | Yes |
| Filter by game version | Yes | Yes | Yes |
| Sort by downloads | Yes | Not listed | Not listed |
| Sort by follows | Yes | Not listed | Not listed |
| Sort by newest | Yes | Not listed | Not listed |
Configure the run
Drive the Actor from a search query, categories, loaders, and Minecraft versions, alone or together, and filters run as each mod is read so only matches reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10
}
A larger pull:
{
"maxItems": 200
}
Pricing
Pay-per-result: $0.0355 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $3.55 |
| 1,000 results | $35.50 |
| 10,000 results | $355.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Modrinth Mods Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Modrinth through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/modrinth-mods-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check your filters. If you combine multiple categories, they use AND, so a mod must match all selected categories. Try removing some filters or broadening your search query.
Why am I only getting 10 items?
Free users are limited to 10 items as a preview. Upgrade to a paid plan to increase maxItems up to 1,000,000.
Why are some mods missing from the results?
Modrinth may have changed its layout or the mod may be hidden. Try running again later or check if the mod is still listed on Modrinth.
How do I filter by a specific Minecraft version?
Use the gameVersions input and select the version from the dropdown. Multiple versions combine with OR.
Why is the run slow?
Scraping many mods takes time. Reduce maxItems or narrow your filters to speed up the run.
FAQ
| Question | Answer |
|---|---|
| Do I need a Modrinth API key? | No. This Actor reads the public Modrinth website directly, so no API key or registration is required. |
| Can I scrape all mods on Modrinth? | Yes. Leave the search query empty and set maxItems to a high number to browse all mods, optionally filtered by category, loader, or version. |
| What data does each mod include? | Each mod returns its title, slug, description, author, downloads, follows, categories, loaders, game versions, and other metadata in a flat row. |
| How do I filter by multiple loaders? | Select multiple loaders in the input. They combine with OR, so a mod matching any selected loader is returned. |
| Can I filter by multiple Minecraft versions? | Yes. Select multiple game versions; they combine with OR, so a mod supporting any selected version is returned. |
| How do I sort results? | Use the sortBy input to order by relevance, downloads, follows, newest, or recently updated. |
| Is there a limit on how many mods I can scrape? | Free users are limited to 10 items as a preview. Paid users can scrape up to 1,000,000 mods per run. |
| Can I export the data? | Yes. The Actor outputs a dataset that you can export to CSV, JSON, Excel, or XML. |
| Does this work for modpacks or resource packs? | This Actor focuses on mods. For modpacks or resource packs, you may need a different scraper or adjust the search query. |
| How often is the data updated? | The Actor scrapes live data from Modrinth at the time of the run, so you get the latest information. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Modrinth. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| searchQuery | string | Free-text search across mod titles, descriptions and slugs (e.g. "sodium", "jei", "create"). Leave empty to browse all mods. | not set |
| maxItems | integer | Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. | 10 |
| sortBy | string (5 options) | How to order results. | relevance |
| categories | array | Filter by mod categories. Multiple values combine with AND. | not set |
| loaders | array | Filter by mod loader (Fabric, Forge, NeoForge, Quilt, etc.). Multiple values combine with OR. | not set |
| gameVersions | array | Filter by supported Minecraft release version (e.g. 1.21.4, 1.20.1). Multiple values combine with OR. | not set |
Pricing
from $26.62 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.02662 to $0.0355 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~modrinth-mods-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.