# Modrinth Mods Scraper (`parseforge/modrinth-mods-scraper`) Actor Search the Modrinth catalog of Minecraft mods, modpacks, resource packs, shaders, plugins and data packs. Returns slugs, authors, downloads, follows, supported versions, mod loaders, license, gallery and more. - **URL**: https://apify.com/parseforge/modrinth-mods-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Developer tools, Business, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $26.62 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐ŸŽฎ 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
InputTypeDefaultBehavior
querystring"fabric"Free-text search across titles, slugs and descriptions. Empty = browse the full catalogue.
projectTypestring""One of 6 Modrinth project types. Empty = any type.
indexstring"relevance"Sort by relevance, downloads, follows, newest, or updated.
categoriesstring[][]OR-combined list of category slugs (60+ tags supported).
loadersstring[][]OR-combined list of mod loaders (Fabric, Forge, NeoForge, Quilt, Paper, etc.).
gameVersionsstring[][]OR-combined list of supported Minecraft versions like "1.21.1".
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
**Example: top 50 Fabric optimization mods for Minecraft 1.21.1.** ```json { "maxItems": 50, "query": "", "projectType": "mod", "index": "downloads", "categories": ["optimization"], "loaders": ["fabric"], "gameVersions": ["1.21.1"] } ```` **Example: most-followed shader packs.** ```json { "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
โšก Hit Fabric optimization mod: Sodium ```json { "iconUrl": "https://cdn.modrinth.com/data/AANobbMI/icon.png", "title": "Sodium", "slug": "sodium", "url": "https://modrinth.com/mod/sodium", "projectId": "AANobbMI", "projectType": "mod", "author": "jellysquid3", "authorId": "uhPSqlnd", "organization": "CaffeineMC", "organizationId": "caffeinemc", "description": "The fastest and most compatible rendering optimization mod for Minecraft.", "categories": ["fabric", "optimization"], "displayCategories": ["optimization"], "clientSide": "required", "serverSide": "unsupported", "license": "LGPL-3.0-only", "downloads": 28150412, "follows": 15028, "latestVersion": "1.21.1", "gameVersionsSupportedCount": 47, "gameVersionsSupported": ["1.16.5", "1.17", "1.18", "1.19", "1.20", "1.21", "1.21.1"], "gallery": ["https://cdn.modrinth.com/data/AANobbMI/images/2025-01-04.png"], "featuredGallery": "https://cdn.modrinth.com/data/AANobbMI/images/featured.png", "color": 2237017, "dateCreated": "2021-01-04T11:13:55Z", "dateModified": "2026-04-21T18:02:44Z", "scrapedAt": "2026-05-15T00:00:00.000Z" } ```
๐ŸŒŒ Shader pack: Complementary Shaders ```json { "iconUrl": "https://cdn.modrinth.com/data/HVnmMxH1/icon.png", "title": "Complementary Shaders - Reimagined", "slug": "complementary-reimagined", "url": "https://modrinth.com/shader/complementary-reimagined", "projectId": "HVnmMxH1", "projectType": "shader", "author": "EminGT", "authorId": "PJqYQYxP", "organization": null, "organizationId": null, "description": "Complementary Reimagined is a shader pack with high quality visuals and great performance.", "categories": ["iris", "optifine", "atmosphere", "reflections", "semi-realistic"], "displayCategories": ["atmosphere", "reflections"], "clientSide": "required", "serverSide": "unsupported", "license": "LicenseRef-CSPLv2", "downloads": 7521430, "follows": 6311, "latestVersion": "1.21", "gameVersionsSupportedCount": 18, "gameVersionsSupported": ["1.16.5", "1.20.4", "1.21"], "gallery": ["https://cdn.modrinth.com/data/HVnmMxH1/images/sunrise.png"], "featuredGallery": "https://cdn.modrinth.com/data/HVnmMxH1/images/featured.png", "color": 7711680, "dateCreated": "2022-09-28T16:08:11Z", "dateModified": "2026-04-12T09:40:00Z", "scrapedAt": "2026-05-15T00:00:00.000Z" } ```
๐Ÿ“ฆ Modpack: Better MC [FABRIC] ```json { "iconUrl": "https://cdn.modrinth.com/data/Y1vfRwYJ/icon.png", "title": "Better MC [FABRIC]", "slug": "better-mc-fabric-bmc4", "url": "https://modrinth.com/modpack/better-mc-fabric-bmc4", "projectId": "Y1vfRwYJ", "projectType": "modpack", "author": "SHXRKIE", "authorId": "iH98HTXq", "organization": null, "organizationId": null, "description": "An immersive modpack which adds tons of new content while keeping vanilla feel intact.", "categories": ["adventure", "combat", "magic", "fabric"], "displayCategories": ["adventure", "combat", "magic"], "clientSide": "required", "serverSide": "required", "license": "ARR", "downloads": 4128003, "follows": 4012, "latestVersion": "1.21.1", "gameVersionsSupportedCount": 6, "gameVersionsSupported": ["1.20.1", "1.20.4", "1.21", "1.21.1"], "gallery": ["https://cdn.modrinth.com/data/Y1vfRwYJ/images/screen1.png"], "featuredGallery": "https://cdn.modrinth.com/data/Y1vfRwYJ/images/featured.png", "color": 4474697, "dateCreated": "2023-04-15T13:11:00Z", "dateModified": "2026-05-02T18:20:00Z", "scrapedAt": "2026-05-15T00:00:00.000Z" } ```
*** ### โœจ 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](https://console.apify.com/sign-up?fpr=vmoqkp) (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](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) 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**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Modrinth%20Mods%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Modrinth%20Mods%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Modrinth%20Mods%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Modrinth%20Mods%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ 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](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe project data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/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**](https://apify.com/parseforge/nuget-packages-scraper) - .NET package catalogue and download history - [**๐Ÿฆ€ Crates.io Scraper**](https://apify.com/parseforge/crates-scraper) - Rust crate metadata and downloads - [**๐Ÿ“ฆ Hex.pm Elixir Packages Scraper**](https://apify.com/parseforge/hex-elixir-packages-scraper) - Elixir/Erlang package catalogue - [**โ˜๏ธ cdnjs Libraries Scraper**](https://apify.com/parseforge/cdnjs-libraries-scraper) - Front-end JS and CSS libraries hosted on cdnjs - [**๐Ÿ“ฆ Docker Hub Scraper**](https://apify.com/parseforge/dockerhub-scraper) - Container image metadata and pulls > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) 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. # Actor input Schema ## `query` (type: `string`): Free-text search across Modrinth project titles, slugs and descriptions. Leave blank to browse the full catalog ordered by the chosen sort. ## `projectType` (type: `string`): Restrict to one Modrinth project type. Leave blank to include all types. ## `index` (type: `string`): Sort criterion for results. Note: "Relevance" requires a query term โ€” leave on "Downloads" or "Follows" when query is empty. ## `categories` (type: `array`): Filter to projects tagged with any of these category slugs (e.g. 'adventure', 'magic', 'optimization', 'library'). Combined with OR. ## `loaders` (type: `array`): Restrict to projects compatible with these mod loaders. Combined with OR. ## `gameVersions` (type: `array`): Restrict to projects supporting at least one of these Minecraft versions (e.g. '1.21.1', '1.20.4'). Combined with OR. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "query": "", "projectType": "", "index": "relevance", "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): Overview of scraped data ## `fullData` (type: `string`): Complete dataset # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "projectType": "", "index": "relevance", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/modrinth-mods-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "projectType": "", "index": "relevance", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/modrinth-mods-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "projectType": "", "index": "relevance", "maxItems": 10 }' | apify call parseforge/modrinth-mods-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/modrinth-mods-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Modrinth Mods Scraper", "description": "Search the Modrinth catalog of Minecraft mods, modpacks, resource packs, shaders, plugins and data packs. Returns slugs, authors, downloads, follows, supported versions, mod loaders, license, gallery and more.", "version": "0.0", "x-build-id": "VnAhzaz7aWWphFalC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~modrinth-mods-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-modrinth-mods-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~modrinth-mods-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-modrinth-mods-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~modrinth-mods-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-modrinth-mods-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Search query", "type": "string", "description": "Free-text search across Modrinth project titles, slugs and descriptions. Leave blank to browse the full catalog ordered by the chosen sort.", "default": "" }, "projectType": { "title": "Project type", "enum": [ "", "mod", "modpack", "resourcepack", "shader", "datapack", "plugin" ], "type": "string", "description": "Restrict to one Modrinth project type. Leave blank to include all types.", "default": "" }, "index": { "title": "Sort by", "enum": [ "relevance", "downloads", "follows", "newest", "updated" ], "type": "string", "description": "Sort criterion for results. Note: \"Relevance\" requires a query term โ€” leave on \"Downloads\" or \"Follows\" when query is empty.", "default": "relevance" }, "categories": { "title": "Categories", "uniqueItems": true, "type": "array", "description": "Filter to projects tagged with any of these category slugs (e.g. 'adventure', 'magic', 'optimization', 'library'). Combined with OR.", "items": { "type": "string", "enum": [ "adventure", "atmosphere", "audio", "blocks", "bloom", "bosses", "cartoon", "challenging", "classes", "colored-lighting", "combat", "core-shaders", "cursed", "custom-content", "decoration", "dungeons", "economy", "entities", "environment", "equipment", "fantasy", "foliage", "fonts", "food", "game-mechanics", "gui", "items", "kitchen-sink", "library", "lightweight", "locale", "magic", "management", "minigame", "mobs", "models", "multiplayer", "optimization", "path-tracing", "pbr", "potato", "pve", "pvp", "quests", "realistic", "reflections", "rpg", "screenshot", "semi-realistic", "shadows", "simplistic", "social", "storage", "technology", "themed", "transportation", "tweaks", "utility", "vanilla-like", "worldgen" ] } }, "loaders": { "title": "Loaders", "uniqueItems": true, "type": "array", "description": "Restrict to projects compatible with these mod loaders. Combined with OR.", "items": { "type": "string", "enum": [ "babric", "bta-babric", "bukkit", "bungeecord", "canvas", "datapack", "fabric", "folia", "forge", "geyser", "iris", "java-agent", "legacy-fabric", "liteloader", "minecraft", "modloader", "neoforge", "nilloader", "optifine", "ornithe", "paper", "purpur", "quilt", "rift", "spigot", "sponge", "vanilla", "velocity", "waterfall" ] } }, "gameVersions": { "title": "Minecraft versions", "uniqueItems": true, "type": "array", "description": "Restrict to projects supporting at least one of these Minecraft versions (e.g. '1.21.1', '1.20.4'). Combined with OR.", "items": { "type": "string", "enum": [ "26.2-snapshot-7", "26.2-snapshot-6", "26.2-snapshot-5", "26.2-snapshot-4", "26.2-snapshot-3", "26.2-snapshot-2", "26.1.2", "26.1.2-rc-1", "26.2-snapshot-1", "26w14a", "26.1.1", "26.1.1-rc-1", "26.1", "26.1-rc-3", "26.1-rc-2", "26.1-rc-1", "26.1-pre-3", "26.1-pre-2", "26.1-pre-1", "26.1-snapshot-11", "26.1-snapshot-10", "26.1-snapshot-9", "26.1-snapshot-8", "26.1-snapshot-7", "26.1-snapshot-6", "26.1-snapshot-5", "26.1-snapshot-4", "26.1-snapshot-3", "26.1-snapshot-2", "26.1-snapshot-1", "1.21.11", "1.21.11-rc3", "1.21.11-rc2", "1.21.11-rc1", "1.21.11-pre5", "1.21.11-pre4", "1.21.11-pre3", "1.21.11-pre2", "1.21.11-pre1", "25w46a", "25w45a", "25w44a", "25w43a", "25w42a", "25w41a", "1.21.10", "1.21.10-rc1", "1.21.9", "1.21.9-rc1", "1.21.9-pre4", "1.21.9-pre3", "1.21.9-pre2", "1.21.9-pre1", "25w37a", "25w36b", "25w36a", "25w35a", "25w34b", "25w34a", "25w33a", "25w32a", "25w31a", "1.21.8", "1.21.8-rc1", "1.21.7", "1.21.7-rc2", "1.21.7-rc1", "1.21.6", "1.21.6-rc1", "1.21.6-pre4", "1.21.6-pre3", "1.21.6-pre2", "1.21.6-pre1", "25w21a", "25w20a", "25w19a", "25w18a", "25w17a", "25w16a", "25w15a", "25w14craftmine", "1.21.5", "1.21.5-rc2", "1.21.5-rc1", "1.21.5-pre3", "1.21.5-pre2", "1.21.5-pre1", "25w10a", "25w09b", "25w09a", "25w08a", "25w07a", "25w06a", "25w05a", "25w04a", "25w03a", "25w02a", "1.21.4", "1.21.4-rc3", "1.21.4-rc2", "1.21.4-rc1", "1.21.4-pre3", "1.21.4-pre2", "1.21.4-pre1", "24w46a", "24w45a", "24w44a", "1.21.3", "1.21.2", "1.21.2-rc2", "1.21.2-rc1", "1.21.2-pre5", "1.21.2-pre4", "1.21.2-pre3", "1.21.2-pre2", "1.21.2-pre1", "24w40a", "24w39a", "24w38a", "24w37a", "24w36a", "24w35a", "24w34a", "24w33a", "1.21.1", "1.21.1-rc1", "1.21", "1.21-rc1", "1.21-pre4", "1.21-pre3", "1.21-pre2", "1.21-pre1", "24w21b", "24w21a", "24w20a", "24w19b", "24w19a", "24w18a", "1.20.6", "1.20.6-rc1", "1.20.5", "1.20.5-rc3", "1.20.5-rc2", "1.20.5-rc1", "1.20.5-pre4", "1.20.5-pre3", "1.20.5-pre2", "1.20.5-pre1", "24w14a", "24w14potato", "24w13a", "24w12a", "24w11a", "24w10a", "24w09a", "24w07a", "24w06a", "24w05b", "24w05a", "24w04a", "24w03b", "24w03a", "23w51b", "23w51a", "1.20.4", "1.20.4-rc1", "1.20.3", "1.20.3-rc1", "1.20.3-pre4", "1.20.3-pre3", "1.20.3-pre2", "1.20.3-pre1", "23w46a", "23w45a", "23w44a", "23w43b", "23w43a", "23w42a", "23w41a", "23w40a", "1.20.2", "1.20.2-rc2", "1.20.2-rc1", "1.20.2-pre4", "1.20.2-pre3", "1.20.2-pre2", "1.20.2-pre1", "23w35a", "23w33a", "23w32a", "23w31a", "1.20.1", "1.20.1-rc1", "1.20", "1.20-rc1", "1.20-pre7", "1.20-pre6", "1.20-pre5", "1.20-pre4", "1.20-pre3", "1.20-pre2", "1.20-pre1", "23w18a", "23w17a", "23w16a", "23w14a", "23w13a_or_b", "23w13a", "23w12a", "1.19.4", "1.19.4-rc3", "1.19.4-rc2", "1.19.4-rc1", "1.19.4-pre4", "1.19.4-pre3", "1.19.4-pre2", "1.19.4-pre1", "23w07a", "23w06a", "23w05a", "23w04a", "23w03a", "1.19.3", "1.19.3-rc3", "1.19.3-rc2", "1.19.3-rc1", "1.19.3-pre3", "1.19.3-pre2", "1.19.3-pre1", "22w46a", "22w45a", "22w44a", "22w43a", "22w42a", "1.19.2", "1.19.2-rc2", "1.19.2-rc1", "1.19.1", "1.19.1-rc3", "1.19.1-rc2", "1.19.1-pre6", "1.19.1-pre5", "1.19.1-pre4", "1.19.1-pre3", "1.19.1-pre2", "1.19.1-rc1", "1.19.1-pre1", "22w24a", "1.19", "1.19-rc2", "1.19-rc1", "1.19-pre5", "1.19-pre4", "1.19-pre3", "1.19-pre2", "1.19-pre1", "22w19a", "22w18a", "22w17a", "22w16b", "22w16a", "22w15a", "22w14a", "22w13oneblockatatime", "22w13a", "22w12a", "22w11a", "1.18.2", "1.18.2-rc1", "1.18.2-pre3", "1.18.2-pre2", "1.18.2-pre1", "22w07a", "22w06a", "22w05a", "22w03a", "1.18.1", "1.18.1-rc3", "1.18.1-rc2", "1.18.1-rc1", "1.18.1-pre1", "1.18", "1.18-rc4", "1.18-rc3", "1.18-rc2", "1.18-rc1", "1.18-pre8", "1.18-pre7", "1.18-pre6", "1.18-pre5", "1.18-pre4", "1.18-pre3", "1.18-pre2", "1.18-pre1", "21w44a", "21w43a", "21w42a", "21w41a", "21w40a", "21w39a", "21w38a", "21w37a", "1.17.1", "1.17.1-rc2", "1.17.1-rc1", "1.17.1-pre3", "1.17.1-pre2", "1.17.1-pre1", "1.17", "1.17-rc2", "1.17-rc1", "1.17-pre5", "1.17-pre4", "1.17-pre3", "1.17-pre2", "1.17-pre1", "21w20a", "21w19a", "21w18a", "21w17a", "21w16a", "21w15a", "21w14a", "21w13a", "21w11a", "21w10a", "21w08b", "21w08a", "21w07a", "21w06a", "21w05b", "21w05a", "21w03a", "1.16.5", "1.16.5-rc1", "20w51a", "20w49a", "20w48a", "20w46a", "20w45a", "1.16.4", "1.16.4-rc1", "1.16.4-pre2", "1.16.4-pre1", "1.16.3", "1.16.3-rc1", "1.16.2", "1.16.2-rc2", "1.16.2-rc1", "1.16.2-pre3", "1.16.2-pre2", "1.16.2-pre1", "20w30a", "20w29a", "20w28a", "20w27a", "1.16.1", "1.16", "1.16-rc1", "1.16-pre8", "1.16-pre7", "1.16-pre6", "1.16-pre5", "1.16-pre4", "1.16-pre3", "1.16-pre2", "1.16-pre1", "20w22a", "20w21a", "20w20b", "20w20a", "20w19a", "20w18a", "20w17a", "20w16a", "20w15a", "20w14a", "20w14infinite", "20w13b", "20w13a", "20w12a", "20w11a", "20w10a", "20w09a", "20w08a", "20w07a", "20w06a", "1.15.2", "1.15.2-pre2", "1.15.2-pre1", "1.15.1", "1.15.1-pre1", "1.15", "1.15-pre7", "1.15-pre6", "1.15-pre5", "1.15-pre4", "1.15-pre3", "1.15-pre2", "1.15-pre1", "19w46b", "19w46a", "19w45b", "19w45a", "19w44a", "19w42a", "19w41a", "19w40a", "19w39a", "19w38b", "19w38a", "19w37a", "19w36a", "19w35a", "19w34a", "1.14.4", "1.14.4-pre7", "1.14.4-pre6", "1.14.4-pre5", "1.14.4-pre4", "1.14.4-pre3", "1.14.4-pre2", "1.14.4-pre1", "1.14.3", "1.14.3-pre4", "1.14.3-pre3", "1.14.3-pre2", "1.14.3-pre1", "1.14.2", "1.14.2-pre4", "1.14.2-pre3", "1.14.2-pre2", "1.14.2-pre1", "1.14.1", "1.14.1-pre2", "1.14.1-pre1", "1.14", "1.14-pre5", "1.14-pre4", "1.14-pre3", "1.14-pre2", "1.14-pre1", "19w14b", "19w14a", "3D-Shareware-v1.34", "19w13b", "19w13a", "19w12b", "19w12a", "19w11b", "19w11a", "19w09a", "19w08b", "19w08a", "19w07a", "19w06a", "19w05a", "19w04b", "19w04a", "19w03c", "19w03b", "19w03a", "19w02a", "18w50a", "18w49a", "18w48b", "18w48a", "18w47b", "18w47a", "18w46a", "18w45a", "18w44a", "18w43c", "18w43b", "18w43a", "1.13.2", "1.13.2-pre2", "1.13.2-pre1", "1.13.1", "1.13.1-pre2", "1.13.1-pre1", "18w33a", "18w32a", "18w31a", "18w30b", "18w30a", "1.13", "1.13-pre10", "1.13-pre9", "1.13-pre8", "1.13-pre7", "1.13-pre6", "1.13-pre5", "1.13-pre4", "1.13-pre3", "1.13-pre2", "1.13-pre1", "18w22c", "18w22b", "18w22a", "18w21b", "18w21a", "18w20c", "18w20b", "18w20a", "18w19b", "18w19a", "18w16a", "18w15a", "18w14b", "18w14a", "18w11a", "18w10d", "18w10c", "18w10b", "18w10a", "18w09a", "18w08b", "18w08a", "18w07c", "18w07b", "18w07a", "18w06a", "18w05a", "18w03b", "18w03a", "18w02a", "18w01a", "17w50a", "17w49b", "17w49a", "17w48a", "17w47b", "17w47a", "17w46a", "17w45b", "17w45a", "17w43b", "17w43a", "1.12.2", "1.12.2-pre2", "1.12.2-pre1", "1.12.1", "1.12.1-pre1", "17w31a", "1.12", "1.12-pre7", "1.12-pre6", "1.12-pre5", "1.12-pre4", "1.12-pre3", "1.12-pre2", "1.12-pre1", "17w18b", "17w18a", "17w17b", "17w17a", "17w16b", "17w16a", "17w15a", "17w14a", "17w13b", "17w13a", "17w06a", "1.11.2", "1.11.1", "16w50a", "1.11", "1.11-pre1", "16w44a", "16w43a", "16w42a", "16w41a", "16w40a", "16w39c", "16w39b", "16w39a", "16w38a", "16w36a", "16w35a", "16w33a", "16w32b", "16w32a", "1.10.2", "1.10.1", "1.10", "1.10-pre2", "1.10-pre1", "16w21b", "16w21a", "16w20a", "1.9.4", "1.9.3", "1.9.3-pre3", "1.9.3-pre2", "1.9.3-pre1", "16w15b", "16w15a", "16w14a", "1.RV-Pre1", "1.9.2", "1.9.1", "1.9.1-pre3", "1.9.1-pre2", "1.9.1-pre1", "1.9", "1.9-pre4", "1.9-pre3", "1.9-pre2", "1.9-pre1", "16w07b", "16w07a", "16w06a", "16w05b", "16w05a", "16w04a", "16w03a", "16w02a", "15w51b", "15w51a", "15w50a", "15w49b", "1.8.9", "15w49a", "15w47c", "15w47b", "15w47a", "15w46a", "15w45a", "15w44b", "15w44a", "15w43c", "15w43b", "15w43a", "15w42a", "15w41b", "15w41a", "15w40b", "15w40a", "15w39c", "15w39b", "15w39a", "15w38b", "15w38a", "15w37a", "15w36d", "15w36c", "15w36b", "15w36a", "15w35e", "15w35d", "15w35c", "15w35b", "15w35a", "15w34d", "15w34c", "15w34b", "15w34a", "15w33c", "15w33b", "15w33a", "15w32c", "15w32b", "15w32a", "15w31c", "15w31b", "15w31a", "1.8.8", "1.8.7", "1.8.6", "1.8.5", "1.8.4", "15w14a", "1.8.3", "1.8.2", "1.8.2-pre7", "1.8.2-pre6", "1.8.2-pre5", "1.8.2-pre4", "1.8.2-pre3", "1.8.2-pre2", "1.8.2-pre1", "1.8.1", "1.8.1-pre5", "1.8.1-pre4", "1.8.1-pre3", "1.8.1-pre2", "1.8.1-pre1", "1.8", "1.8-pre3", "1.8-pre2", "1.8-pre1", "14w34d", "14w34c", "14w34b", "14w34a", "14w33c", "14w33b", "14w33a", "14w32d", "14w32c", "14w32b", "14w32a", "14w31a", "14w30c", "14w30b", "14w30a", "14w29b", "14w29a", "14w28b", "14w28a", "14w27b", "14w27a", "14w26c", "14w26b", "14w26a", "14w25b", "14w25a", "14w21b", "14w21a", "14w20b", "14w20a", "1.7.10", "1.7.10-pre4", "1.7.10-pre3", "1.7.10-pre2", "1.7.10-pre1", "14w19a", "14w18b", "14w18a", "14w17a", "14w11b", "1.7.9", "1.7.8", "1.7.7", "1.7.6", "14w11a", "1.7.6-pre2", "1.7.6-pre1", "14w10c", "14w10b", "14w10a", "14w08a", "1.7.5", "14w07a", "14w06b", "14w06a", "14w05b", "14w05a", "14w04b", "14w04a", "14w03b", "14w03a", "14w02c", "14w02b", "14w02a", "1.7.4", "1.7.3", "13w49a", "13w48b", "13w48a", "13w47e", "13w47d", "13w47c", "13w47b", "13w47a", "1.7.2", "1.7.1", "1.7", "13w43a", "13w42b", "13w42a", "13w41b", "13w41a", "13w39b", "13w39a", "13w38c", "13w38b", "13w38a", "1.6.4", "13w37b", "1.6.3", "13w37a", "13w36b", "13w36a", "1.6.2", "1.6.1", "1.6", "13w26a", "13w25c", "13w25b", "13w25a", "13w24b", "13w24a", "13w23b", "13w23a", "13w22a", "13w21b", "13w21a", "13w19a", "13w18c", "13w18b", "13w18a", "13w17a", "1.5.2", "13w16b", "13w16a", "1.5.1", "1.5", "1.4.7", "1.4.6", "1.4.5", "1.4.4", "1.4.3", "1.4.2", "1.4.1", "1.4", "1.3.2", "1.3.1", "1.3", "1.2.5", "1.2.4", "1.2.3", "1.2.2", "1.2.1", "1.1", "1.0", "b1.8.1", "b1.8", "b1.7.3", "b1.7.2", "b1.7", "b1.6.6", "b1.6.5", "b1.6.4", "b1.6.3", "b1.6.2", "b1.6.1", "b1.6", "b1.5_01", "b1.5", "b1.4_01", "b1.4", "b1.3_01", "b1.3b", "b1.2_02", "b1.2_01", "b1.2", "b1.1_02", "b1.1_01", "b1.0.2", "b1.0_01", "b1.0", "a1.2.6", "a1.2.5", "a1.2.4_01", "a1.2.3_04", "a1.2.3_02", "a1.2.3_01", "a1.2.3", "a1.2.2b", "a1.2.2a", "a1.2.1_01", "a1.2.1", "a1.2.0_02", "a1.2.0_01", "a1.2.0", "a1.1.2_01", "a1.1.2", "a1.1.0", "a1.0.17_04", "a1.0.17_02", "a1.0.16", "a1.0.15", "a1.0.14", "a1.0.11", "a1.0.5_01", "a1.0.4", "inf-20100618", "c0.30_01c", "c0.0.13a", "c0.0.13a_03", "c0.0.11a", "rd-161348", "rd-160052", "rd-20090515", "rd-132328", "rd-132211" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```