Thunderstore APIthunderstore.io ↗
Access Thunderstore mod metadata, version history, dependencies, download URLs, community listings, and decompiled C# source code via 5 structured endpoints.
What is the Thunderstore API?
The Thunderstore.io API exposes 5 endpoints covering gaming mod communities, mod search, full package metadata, and decompiled source code. Use search_mods to query mods across all communities or within a specific game by slug, get_mod_details to pull version history and dependency lists for a single package, and get_mod_source to retrieve decompiled C# file contents — up to 10,000 characters per file — directly from a mod's source tab.
curl -X GET 'https://api.parse.bot/scraper/c22e04e9-1296-4d3a-9bb8-dedeef396703/list_communities?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace thunderstore-io-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Thunderstore.io mod discovery: browse communities, search mods, inspect source."""
from parse_apis.thunderstore_io_api import Thunderstore, Ordering, ModNotFound
client = Thunderstore()
# List gaming communities — each is a game with its own mod ecosystem.
for community in client.communities.list(limit=5):
print(community.name, community.identifier, community.discord_url)
# Search for popular mods by rating across Risk of Rain 2.
mod = client.mods.search(
community="risk-of-rain-2",
ordering=Ordering.RATING_SCORE_DESC,
limit=1,
).first()
if mod:
print(mod.full_name, mod.rating_score, mod.latest.version_number)
# Drill into the mod's decompiled source files (sub-resource).
source = mod.source.get()
for sf in source.source_files[:3]:
print(sf.filename, sf.is_truncated, len(sf.content))
# Construct a community by slug and list its mods directly.
windrose = client.community("windrose")
for m in windrose.mods.list(limit=3):
print(m.full_name, m.owner, m.rating_score)
# Typed error handling for a non-existent mod.
try:
client.mods.search(community="risk-of-rain-2", query="nonexistent_xyz_mod_00000", limit=1).first()
except ModNotFound as exc:
print(f"Not found: {exc.namespace}/{exc.name}")
print("exercised: communities.list / mods.search / mod.source.get / community.mods.list")
Retrieve all communities on Thunderstore. Each community represents a game or project with its own mod ecosystem. Paginated internally; the limit parameter caps the total returned. Communities are identified by a slug used in other endpoints.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of communities to return. |
{
"type": "object",
"fields": {
"items": "array of community objects each containing identifier, name, discord_url, wiki_url, and require_package_listing_approval"
},
"sample": {
"data": {
"items": [
{
"name": "Burglin' Gnomes",
"wiki_url": null,
"identifier": "burglin-gnomes",
"discord_url": "https://discord.gg/WmHc6MAhuB",
"require_package_listing_approval": false
}
]
},
"status": "success"
}
}About the Thunderstore API
Communities and Mod Listings
list_communities returns every game or project community on Thunderstore, with each object including an identifier slug, name, discord_url, wiki_url, and require_package_listing_approval flag. The identifier slug feeds directly into list_mods, which returns the full v1 package listing for a community — including complete version history, rating_score, is_pinned, and is_deprecated status for every mod. Note that very large communities like riskofrain2 or lethal-company can exceed response size limits; search_mods is more appropriate for those.
Searching and Filtering Mods
search_mods supports a query string, a community slug filter (hyphenated form, e.g. risk-of-rain-2), an ordering field (prefix with - to reverse), and a limit cap on results. Each result includes namespace, name, full_name, owner, package_url, date_created, date_updated, rating_score, and community listing details with the latest version metadata.
Mod Details and Source Code
get_mod_details takes a namespace and name and returns the full mod record: dependencies, all version download URLs, community listings, pin and deprecation status, and dates. get_mod_source retrieves decompiled C# files from the mod's source tab — each entry in source_files includes filename, content (truncated at 10,000 characters with an is_truncated flag), and any linked GitHub repository URL. Not every mod has source code available; the endpoint returns whatever the source tab exposes for that package.
The Thunderstore API is a managed, monitored endpoint for thunderstore.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when thunderstore.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official thunderstore.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a mod dependency resolver by walking
get_mod_detailsdependency lists across multiple namespaces. - Track rating and download trends for mods in a specific community using
search_modswithorderingandcommunityfilters. - Index all mods for a game with
list_modsand expose a searchable catalog with version history and download links. - Audit deprecated mods in a community by filtering
list_modsresults on theis_deprecatedfield. - Retrieve decompiled C# source files via
get_mod_sourceto analyze mod implementations or check for dependency usage patterns. - Enumerate all Thunderstore communities with
list_communitiesto discover games with active mod ecosystems and their Discord/wiki links. - Monitor new or updated mods by sorting
search_modsresults bydate_updateddescending for a given community slug.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Thunderstore have an official developer API?+
What does `get_mod_source` return, and are all mods covered?+
get_mod_source returns an array of decompiled C# files from the mod's source tab, each with a filename, content string (capped at 10,000 characters), and an is_truncated boolean. It also surfaces any linked GitHub URL. Not all mods have source available — the endpoint returns whatever the source tab exposes for that package, which may be empty.Why does `list_mods` fail for large communities like `riskofrain2`?+
list_mods endpoint uses the v1 bulk package listing, which returns all mods and their full version history in a single response. Very large communities can push that response past size limits. For those communities, use search_mods with the community parameter and paginate via the limit field instead.Does the API return mod reviews or user comments?+
Can I retrieve download counts or install statistics per mod version?+
rating_score and download URLs per version, but per-version download counts or aggregate install statistics are not returned. You can fork this API on Parse and revise it to add that data if it becomes available on the source.