Factorio Mods Scraper

Export mods from the official Factorio mod portal — ~20k published mods with clean structured data: name, title, owner, summary, downloads, score, category, tags, license, homepage, Factorio version, latest release, and optional full release history.

Data comes from the Factorio mods portal JSON API (/api/mods + /api/mods/{name}/full). No browser, no proxy, no login.

Not affiliated with or sanctioned by Wube Software. Uses the public mod-portal browse endpoints with polite rate limits.

What can it do?

• Full catalog export. Load the portal catalog (page_size=max) and sort by downloads or score.
• Search & filters. Case-insensitive query across name / title / owner / summary / category; optional category and tag filters.
• Sort. Downloads, score, updated, created, or name (ascending / descending).
• Full details (default). Description, tags, license, homepage, thumbnail, images, created/updated dates, release count.
• Release history (optional). Attach newest-first releases[] capped by maxReleasesPerMod.
• Factorio version awareness. Pass factorioVersion and optionally hide incompatible/deprecated mods.
• Fast and cheap. Pure JSON over HTTPS, concurrency ≤ 4 with Retry-After backoff. Runs on 512 MB.

Use cases

• Modding market datasets for AI / RAG about Factorio ecosystems (Space Age, overhauls, QoL)
• Competitor / ecosystem tracking for mod authors (downloads, score, release cadence)
• Lead generation: owner names and homepage / Discord links
• Modpack research: discover popular content by downloads and category
• Scheduled snapshots of the Factorio mod portal catalog

Input

Field	Type	Description
query	string	Case-insensitive text filter. Empty = all (then sort / maxItems).
category	string	content, overhaul, tweaks, utilities, scenarios, mod-packs, localizations, internal, no-category.
tag	string	Optional tag (logistics, trains, combat, …). Forces details fetch.
sort	string	-downloads (default), -score, -updated, -created, name, or ascending variants.
maxItems	integer	Max mods to output (default 100).
hideDeprecated	boolean	Hide deprecated / incompatible mods (default true).
factorioVersion	string	Optional Factorio version (e.g. 2.0.76).
includeDetails	boolean	Fetch full mod details (default true).
includeReleases	boolean	Attach releases[] (default false).
maxReleasesPerMod	integer	Cap on releases when included (default 5; 0 = all).

Example: top mods by downloads:

{ "sort": "-downloads", "maxItems": 100 }

Example: logistics-tagged content mods matching “belt”:

{
  "query": "belt",
  "category": "content",
  "tag": "logistics",
  "sort": "-downloads",
  "maxItems": 50,
  "includeDetails": true
}

Output

One dataset item per mod:

{
  "name": "helmod",
  "title": "Helmod: Assistant for planning your factory",
  "owner": "Helfima",
  "summary": "Assistant for planning your factory…",
  "description": "…",
  "category": "utilities",
  "tags": ["manufacturing"],
  "downloads": 547131,
  "score": 12.5,
  "latestVersion": "2.0.0",
  "factorioVersion": "2.0",
  "homepage": "https://…",
  "license": "MIT",
  "thumbnailUrl": "https://mods.factorio.com/assets/…",
  "createdAt": "2016-01-01T00:00:00Z",
  "updatedAt": "2026-09-01T00:00:00Z",
  "url": "https://mods.factorio.com/mod/helmod",
  "releaseCount": 40,
  "scrapedAt": "2026-10-14T20:00:00+00:00"
}

Pricing

Pay-per-event: $0.002 per mod ($2 per 1,000 results).

Notes

• Uses Factorio’s mod portal JSON API only. Identifies as factorio-mods-scraper (Apify; +https://apify.com/confidential_marina; not affiliated with Wube Software).
• Downloads/score sorts fetch the full catalog once (~12 MB, ~20k mods) then filter locally.
• Rate limits are respected with concurrency ≤ 4, inter-request pacing, and Retry-After backoff.