crawlora / modrinth

v0.1.0 2026-11-13 10:42 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

MIT

• sdk
• API-Client
• web-scraping
• modrinth
• crawlora
• scraping-api
• modrinth-api
• modrinth-scraper
• modrinth-data
• modrinth-project-search-metadata
• modrinth-versions
• modrinth-dependencies
• modrinth-collections
• modrinth-organizations
• modrinth-file-compatibility

Published on Packagist.org on 2026-11-13 11:33 UTC

README

Official Crawlora client packages for the hosted Modrinth API. Access 34 API endpoints covering project search and metadata, versions, dependencies, collections, organizations, and file compatibility from JavaScript/TypeScript, Python, Go, Ruby, Java, PHP, and Rust. These clients call Crawlora's hosted API; they do not scrape Modrinth locally. Requests use your Crawlora account and CRAWLORA_API_KEY; service usage follows your account billing plan. Crawlora is independent from and not affiliated with or endorsed by Modrinth or its owners.

Language packages

• JavaScript / TypeScript: @crawlora-org/modrinth
• Python: crawlora-modrinth
• Go: github.com/Crawlora-org/crawlora-modrinth
• Ruby: crawlora-modrinth
• Java: net.crawlora:crawlora-modrinth:0.1.0
• PHP: crawlora/modrinth
• Rust: crawlora-modrinth

For installation and runnable examples, use the README for your language. See the API endpoint and parameter reference for shared operation details.

Create an account at crawlora.net, open the Crawlora console to get an API key, or read the API documentation. Keep CRAWLORA_API_KEY out of source control.

API coverage and supported endpoints

The seven language clients provide access to all 34 selected public Modrinth API operations. Search or browse by endpoint path and operation ID below; the complete API reference adds parameters, enums, and response details.

Method	Endpoint	API operation	Description
GET	/modrinth/collection/{id}	modrinth-collection	Read a public Modrinth collection
GET	/modrinth/collections	modrinth-collections	Resolve public Modrinth collections
GET	/modrinth/metadata/link-platforms	modrinth-metadata-link-platforms	Get Modrinth link platforms
GET	/modrinth/metadata/loader-fields	modrinth-metadata-loader-fields	Discover Modrinth loader fields
GET	/modrinth/metadata/loader-fields/{field}	modrinth-metadata-loader-field-values	Get Modrinth loader-field values
GET	/modrinth/metadata/loaders	modrinth-metadata-loaders	Get Modrinth loader capabilities
GET	/modrinth/organization/{id}	modrinth-organization	Read a public Modrinth organization
GET	/modrinth/organization/{id}/projects	modrinth-organization-projects	Read a public organization's Modrinth projects
GET	/modrinth/organizations	modrinth-organizations	Resolve public Modrinth organizations
GET	/modrinth/project/{id}	modrinth-project	Get a Modrinth project
GET	/modrinth/project/{id}/check	modrinth-check-project	Resolve a project ID or slug
GET	/modrinth/project/{id}/dependencies	modrinth-dependencies	Get project dependency metadata
GET	/modrinth/project/{id}/disclosures	modrinth-project-disclosures	Get Modrinth public project disclosures
GET	/modrinth/project/{id}/version	modrinth-project-versions	List project versions
GET	/modrinth/project/{id}/version/{number}	modrinth-project-version	Get a project version by number or ID
GET	/modrinth/projects	modrinth-projects	Get native multiple-project metadata
GET	/modrinth/projects_random	modrinth-random-projects	Get native random projects
GET	/modrinth/search	modrinth-search	Search Modrinth projects
GET	/modrinth/statistics	modrinth-statistics	Get Modrinth instance statistics
GET	/modrinth/tag/license/{id}	modrinth-license	Get source license title and text
GET	/modrinth/tag/{type}	modrinth-tags	Discover Modrinth catalog values
GET	/modrinth/updates/{id}/forge_updates.json	modrinth-forge-updates	Get native Forge update metadata
GET	/modrinth/v3/search	modrinth-search-v3	Search current Modrinth projects and servers
POST	/modrinth/v3/search	modrinth-search-v3-body	Search Modrinth using the native v3 JSON body
GET	/modrinth/v3/search/options	modrinth-search-v3-options	Discover Modrinth v3 search options
GET	/modrinth/version/{id}	modrinth-version	Get a version by ID
POST	/modrinth/version_file/project	modrinth-file-projects	Resolve file hashes to projects
GET	/modrinth/version_file/{hash}	modrinth-file-version	Resolve a version by file hash
POST	/modrinth/version_file/{hash}/update	modrinth-file-update	Resolve a compatible update for a file
POST	/modrinth/version_files	modrinth-file-versions	Resolve file hashes to versions
POST	/modrinth/version_files/update	modrinth-files-update	Resolve compatible updates for files
POST	/modrinth/version_files/update_individual	modrinth-files-update-individual	Resolve updates with per-file filters
POST	/modrinth/version_files/update_many	modrinth-files-update-many	List compatible update versions for files
GET	/modrinth/versions	modrinth-versions	Get native multiple-version metadata

License

MIT. See LICENSE.