ParseForge Scrapers

CurseForge Mods Scraper

parseforge/curseforge-mods-scraper

Developer toolsAutomationOther

Scrapes CurseForge mods by search query or from the default listing, with filters for category, Minecraft version, and mod loader. Returns each mod as a flat row with name, author, downloads, summary, and latest file info.

Run this scraper See the API call
Total users
7
Monthly active
0
Total runs
177
Bookmarked
0
Rating
Not rated yet
Last modified
9 days ago

Overview

ParseForge Banner

๐Ÿ”ฅ CurseForge Mods Scraper

๐Ÿš€ Export Minecraft mod data from CurseForge in seconds. Mod name, slug, downloads, categories, loader, supported MC versions, license, author, main file URL, screenshots, and the full description - straight to CSV, Excel, JSON, or XML.

The CurseForge Mods Scraper turns the public CurseForge Minecraft Mods catalog into a clean, structured dataset. It fetches each mod's server-rendered detail page (no API key required, no Cloudflare key needed from you) and parses the embedded React Server Components payload to surface every field the public page exposes.

Coverage spans 52 official Minecraft mod categories (Adventure & RPG, Magic, Storage, Technology, Performance, Utility & QoL, Map and Information, Tinker's Construct, Create, Refined Storage, and more), 7 mod loaders (Forge, Fabric, NeoForge, Quilt, LiteLoader, Cauldron, Any), and every Minecraft release version from 1.7.10 up to the current 1.21.x line.

๐ŸŽฏ Target Audience ๐Ÿ’ก Primary Use Cases
๐ŸŽฎ Modpack creators Identify popular mods by loader and MC version
๐Ÿ› ๏ธ Launcher and tool developers Mirror CurseForge metadata into your own DB
๐Ÿ“Š Data analysts Track download counts, loader market share, license trends
๐ŸŽฅ Content creators Find the top-downloaded mods for a specific version before recording
๐Ÿข Server operators Audit which mods are compatible with your server stack
๐Ÿค– AI / ML teams Build a corpus of mod descriptions and metadata

๐Ÿ“‹ What the CurseForge Mods Scraper does

  • Fetches the CurseForge /minecraft/mc-mods listing or /search?search=... page with a real Chrome TLS fingerprint.
  • Extracts the slug of every mod the SSR page surfaces (up to 20 per query).
  • Visits each mod's detail page and parses the embedded RSC payload for the full project record.
  • Applies post-fetch filters for categoryIds, gameVersions, and modLoaderTypes against the surfaced set.
  • Flattens everything into a 23-field record with imageUrl first and error last.
  • Exports as CSV, Excel, JSON, JSONL, XML, RSS, or HTML.

๐Ÿ’ก Why it matters: the official CurseForge API requires a private API key and the internal web API is hard-locked behind Cloudflare bot management. This actor uses the public detail pages directly - the data you'd see in a browser, without needing your own key or cf_clearance cookie.

๐Ÿ“Š Data fields

Each record includes: author, categories, dateCreated, downloadCount, gameVersion, id, imageUrl, licenseType, modLoader, name, primaryCategory, results, scrapedAt, slug, summary, updateDate, url. These field names come straight from the actor's dataset schema, so what you see here is what lands in your dataset.

โš ๏ธ Good to Know: CurseForge only server-renders the first 20 mods of any listing; the rest is hydrated client-side via a Cloudflare-protected internal API. This scraper returns up to ~20 mods per query. To widen coverage, run multiple queries with different searchQuery terms: that's the recommended workflow. categoryIds, gameVersions, and modLoaderTypes are applied as post-fetch filters on the surfaced set so the input remains honest.

๐Ÿš€ How to use

  1. Sign up. Create a free Apify account w/ $5 credit.
  2. Open the CurseForge Mods Scraper page.
  3. Set inputs. Type a searchQuery and pick a sort field. Optionally add categoryIds, gameVersions, modLoaderTypes.
  4. Run. Click Start. Free users get 10 items, paid users up to 1,000,000 (in batches of ~20 per query).
  5. Export. Download the dataset as CSV, Excel, JSON, JSONL, XML, RSS, or HTML.

๐Ÿ”— Recommended Actors

Actor What it does
Modrinth Mods Scraper Pull the same kind of data from Modrinth's official v2 API.
Steam Store Scraper Game prices, reviews, and metadata from Steam.
GitHub Repo Scraper Repo metadata, stars, releases, contributors.
itch.io Games Scraper Indie game listings, tags, and prices from itch.io.
OurAirports Database Scraper Full global airport reference dataset.

๐Ÿ’ก Pro Tip: browse the complete ParseForge collection for more catalog and marketplace scrapers.

โš ๏ธ Disclaimer: this is an independent tool, not affiliated with Overwolf, CurseForge, or Mojang. Only publicly available data from the CurseForge website is collected. Respect the licenses of the mods you download.

๐Ÿ†˜ Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our contact form or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our Discord. It's the best place to get support and suggest new actors.

Input

FieldTypeWhat it doesDefault
searchQuery string Free-text search across Minecraft mods (e.g. 'jei', 'magic', 'storage'). Leave empty to pull the default popular mods listing. jei
maxItems integer How many mods to collect per run. 10
sortField string (6 options) How to order the listing when no searchQuery is provided. Popularity
categoryIds array Filter results to mods that belong to any of the selected categories. not set
gameVersions array Filter to mods whose main file supports any of these Minecraft versions (e.g. '1.21.1', '1.20.1'). not set
modLoaderTypes array Filter to mods whose main file targets any of these mod loaders. not set

Pricing

from $19.00 per 1,000 results

Charged forWhat it isPrice each
result Single result in the default dataset. $0.019 to $0.021

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.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~curseforge-mods-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "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.

Related scrapers

Run CurseForge Mods Scraper on Apify All scrapers