Godot Asset Library Scraper

Scrape the official Godot Engine Asset Library — thousands of free addons, shaders, tools, scripts, templates, projects and demos for the Godot game engine. Search by keyword or browse by category, engine version, license and support level. HTTP-only via the public Asset Library API. No auth, no proxy required.

What this actor does

• Two modes: search (keyword + filter browse) and byIds (direct asset ID lookup)
• Full filter surface: category (10), asset type (addons vs projects), support level, Godot engine version (2.0 through 4.7), license, author, sort order
• Rich per-asset detail: every record is enriched with the full asset detail payload (description, download URL, repo/issues links, preview images) — not just the summary listing row
• Empty fields are omitted

Output per asset

• assetId, title, description
• type — addon or project
• author, authorId
• category, categoryId
• godotVersion — engine version compatibility
• rating (0-5), license, supportLevel
• version, versionString, lastUpdated
• iconUrl, previewImages[]
• downloadUrl, downloadProvider, downloadCommit (exact git commit/tag zipped for download, when the provider is GitHub), browseUrl (source repo), issuesUrl
• sourceUrl — Asset Library detail page
• recordType: "asset", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byIds
searchQuery	string	–	Keyword search over titles
category	select	–	2D Tools, 3D Tools, Shaders, Materials, Tools, Scripts, Misc, Templates, Projects, Demos
assetType	select	any	any / addon / project
supportLevel	select	–	testing / community / featured
godotVersion	select	–	2.0 – 4.7, unknown, custom_build — matches assets compatible with at least this version (upstream semantics), not an exact-version match
license	select	–	22 supported open-source licenses (MIT, GPLv3, Apache-2.0, CC0, …)
authorUsername	string	–	Restrict to one publisher
sortBy	select	updated	updated / name / cost — note: updated sorts newest-first by default upstream; set reverse: true for oldest-first
reverse	boolean	false	Flip sort order
minRating	integer	–	Drop assets rated below this (0-5)
assetIds	array	–	Asset IDs or full URLs (mode=byIds)
maxItems	integer	20	Hard cap (1-500)
proxyConfiguration	proxy	off	Optional AUTO-group fallback if rate-limited

Example: browse recently updated 3D tools for Godot 4.x

{
  "mode": "search",
  "category": "2",
  "godotVersion": "4.3",
  "sortBy": "updated",
  "reverse": true,
  "maxItems": 50
}

Example: keyword search

{
  "mode": "search",
  "searchQuery": "platformer",
  "assetType": "project",
  "maxItems": 30
}

Example: lookup specific assets

{
  "mode": "byIds",
  "assetIds": ["431", "5311"]
}

Use cases

• Game dev tooling discovery — find shaders, editor plugins and character controllers for a Godot project
• Ecosystem analytics — track how many assets support each engine version or license
• Curated lists — build a "best Godot addons" roundup filtered by support level
• Learning resources — pull sample projects and demos by category
• License auditing — verify an asset's license before bundling it in a commercial project

FAQ

What's the Godot Asset Library? The official, in-editor addon and project marketplace for the open-source Godot game engine, browsable at godotengine.org/asset-library.

Is it free? Yes — every asset on the Library is free and open-source; the license field tells you exactly which license applies.

What's the difference between an addon and a project? Addons are plugins/scripts/shaders you import into an existing project; projects are complete downloadable demos or templates you open directly in Godot.

Why does godotVersion: "4.3" also return assets tagged 4.0? The Asset Library API filters by minimum compatible version, not exact match — this is upstream behavior, confirmed against the live API.

Why is rating almost always 0? The Asset Library's star-rating system currently sees very light community use — this is real upstream data, not a scraper bug.

Why do testing/featured support-level filters sometimes return 0 results? Those curation tiers are used sparingly by the Godot team at any given time; community covers the vast majority of listed assets.

Can I get download links? Yes — downloadUrl points directly at the asset's zip/archive, and browseUrl links to its source repository (usually GitHub).

Why did category 8/9/10 (Templates/Projects/Demos) return 0 results when I also set assetType: "addon"? Those three categories only ever contain project-type assets upstream (Templates/Projects/Demos are full downloadable projects, never addons), so narrowing to both assetType: "addon" and one of those categories is a contradictory combination that legitimately has zero matches. Leave assetType on its default (any) when picking one of those categories, or set assetType: "project".

How fresh is the data? Real-time — every request hits the live Asset Library API, covering the full current catalog (~5,000+ assets across all engine versions).