thunderstore.io APIthunderstore.io ↗
Access Thunderstore mod metadata, version history, dependencies, download URLs, and decompiled C# source code across all gaming communities via a single API.
curl -X GET 'https://api.parse.bot/scraper/c22e04e9-1296-4d3a-9bb8-dedeef396703/list_communities?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Get a paginated list of all communities on Thunderstore. Returns community identifiers, names, and associated links.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of communities to return. |
{
"type": "object",
"fields": {
"data": "array of community objects each containing identifier, name, discord_url, wiki_url, and require_package_listing_approval"
},
"sample": {
"data": [
{
"name": "Lootun",
"wiki_url": null,
"identifier": "lootun",
"discord_url": null,
"require_package_listing_approval": false
},
{
"name": "Windrose",
"wiki_url": "https://windrose.gaming.tools/",
"identifier": "windrose",
"discord_url": "https://discord.gg/2GJJZAkk85",
"require_package_listing_approval": false
}
],
"status": "success"
}
}About the thunderstore.io API
This API provides 5 endpoints for retrieving mod and community data from Thunderstore.io, the mod repository used by games like Lethal Company and Risk of Rain 2. The list_communities endpoint returns community identifiers, Discord links, and approval settings. search_mods supports keyword queries, ordering, and community filtering. get_mod_source goes further, returning decompiled C# file content for any listed mod alongside any linked GitHub repository.
Community and Mod Discovery
The list_communities endpoint returns paginated community objects with fields including identifier, name, discord_url, wiki_url, and require_package_listing_approval. The identifier values feed directly into list_mods and search_mods as the community parameter. list_mods uses the Thunderstore v1 package API to return full mod details for a given community slug, including all versions — but note that very large communities like riskofrain2 or lethal-company may exceed response size limits, making search_mods the better choice for those.
Searching and Filtering Mods
search_mods accepts a query keyword, an ordering field (e.g. rating_score, -last_updated), a community slug in hyphenated form (e.g. risk-of-rain-2), and a limit cap. Results include fields such as namespace, full_name, package_url, date_created, date_updated, rating_score, is_pinned, and deprecation status. The namespace and name fields from these results are the inputs required by both get_mod_details and get_mod_source.
Mod Details and Source Code
get_mod_details returns a single mod object with its latest version, dependency list, community listings, and direct download URLs. get_mod_source returns the source_files array, each entry containing a filename, decompiled content string, and an is_truncated flag — along with any linked GitHub URLs. This makes it straightforward to inspect what a mod actually does without manually downloading and decompiling it.
- Index all mods in a game community and expose a custom search interface filtered by rating or update date.
- Track
date_updatedandrating_scorechanges across mods to detect trending or recently updated packages. - Build a dependency graph for a mod by consuming the dependencies list from
get_mod_details. - Audit decompiled C# source files from
get_mod_sourcefor security review before installing a mod. - Aggregate community metadata from
list_communitiesto build a directory of Thunderstore-supported games. - Monitor
is_deprecatedandis_pinnedflags to notify users when a mod they track changes status. - Pull download URLs from mod version objects to automate mod installation in a custom game launcher.
| 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 | 250 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 `search_mods` return and how is it different from `list_mods`?+
search_mods returns paginated results and supports filtering by query, community (hyphenated slug), and ordering fields like rating_score or -last_updated. list_mods returns all mods in a community in bulk using the v1 package API — it includes full version history but has no search or filter parameters. For large communities, list_mods may hit size limits; search_mods is the practical alternative there.What does `get_mod_source` actually return, and is all content available?+
source_files array with each file's filename and decompiled C# content, plus a boolean is_truncated flag indicating whether the content was cut short due to size. It also returns any github_url linked on the mod's source tab. Source extraction depends on the mod having content on its source tab; not all mods expose this.Does the API return user reviews or comments for mods?+
Can I retrieve version history for every release of a mod, not just the latest?+
list_mods returns all versions for mods in a community. get_mod_details focuses on the latest version and community listings. Full historical version objects are primarily available through the list_mods response. If you need per-version endpoints with direct version slugs, the current endpoints don't expose that as a standalone query — you can fork the API on Parse and add a dedicated version endpoint.