Obsidian Community Plugins & Themes Scraper

Extract data on every community plugin and CSS theme from the official Obsidian releases repository. Get plugin names, authors, descriptions, total download counts, latest versions, GitHub links, and Obsidian marketplace URLs — all from a single actor run.

No authentication or API keys required. Data is sourced from the publicly available obsidian-releases repository maintained by the Obsidian team.

What you get

• 1,700+ community plugins with download statistics, version history, and GitHub links
• 300+ community CSS themes with screenshot URLs and supported color modes
• Clean, structured JSON output ready for analysis, dashboards, or integrations
• Optional text filtering and minimum-download thresholds

Output fields

Plugins mode (default)

Field	Type	Description
plugin_id	string	Unique plugin identifier, e.g. "obsidian-tasks-group"
name	string	Display name, e.g. "Tasks"
author	string	Plugin author name
description	string	Short description of what the plugin does
github_repo	string	GitHub repository in author/repo format
github_url	string	Full GitHub URL, e.g. https://github.com/obsidian-tasks-group/obsidian-tasks
total_downloads	integer	Sum of all version download counts
latest_version	string	Most recently published version, e.g. "7.0.1"
obsidian_url	string	Obsidian marketplace URL, e.g. https://obsidian.md/plugins?id=obsidian-tasks-group

Themes mode

Field	Type	Description
name	string	Theme display name
author	string	Theme author name
github_repo	string	GitHub repository in author/repo format
github_url	string	Full GitHub URL
screenshot_url	string	Direct URL to the theme screenshot image
supported_modes	array	Color modes supported, e.g. ["light", "dark"]

Input options

Field	Type	Default	Description
mode	select	plugins	What to scrape: "plugins" or "themes"
query	string	—	Case-insensitive text filter applied to name, description, and author
minDownloads	integer	—	Minimum total downloads required (plugins mode only)
maxItems	integer	500	Maximum number of records to return

Example inputs

Get the top 50 most-downloaded plugins:

{
  "mode": "plugins",
  "minDownloads": 100000,
  "maxItems": 50
}

Search for all task-management plugins:

{
  "mode": "plugins",
  "query": "task",
  "maxItems": 100
}

Get all community themes:

{
  "mode": "themes",
  "maxItems": 500
}

Get all dark themes:

{
  "mode": "themes",
  "query": "dark",
  "maxItems": 200
}

Example output (plugins mode)

{
  "plugin_id": "obsidian-tasks-group",
  "name": "Tasks",
  "author": "Clare Macrae and Ilya Paranin",
  "description": "Track tasks across your entire vault. Query them and mark them done.",
  "github_repo": "obsidian-tasks-group/obsidian-tasks",
  "github_url": "https://github.com/obsidian-tasks-group/obsidian-tasks",
  "total_downloads": 2150000,
  "latest_version": "7.0.1",
  "obsidian_url": "https://obsidian.md/plugins?id=obsidian-tasks-group",
  "recordType": "plugin",
  "scrapedAt": "2026-01-15T10:30:00+00:00"
}

Use cases

• Plugin discovery — Find the most popular or niche plugins for a specific workflow
• Download trend tracking — Monitor which plugins are gaining traction
• Developer research — Identify feature gaps or competitive landscape in the plugin ecosystem
• Documentation and blogs — Build curated plugin lists or "best of" articles
• Obsidian-based products — Power recommendation engines or plugin directories
• Data analysis — Analyze the Obsidian ecosystem, author productivity, and version release cadence

Data source

All data comes from the official obsidian-releases GitHub repository maintained by Obsidian, Inc. This repository is the single source of truth for community plugins and themes listed in the in-app Community Plugins browser.

• Plugin list: community-plugins.json
• Download statistics: community-plugin-stats.json
• Theme list: community-css-themes.json

Data is publicly accessible with no authentication, rate limits, or terms-of-service restrictions beyond GitHub's standard acceptable use policy.

FAQ

How current is the data? The actor fetches data directly from GitHub on every run, so results always reflect the latest published state of the repository. Obsidian's team typically updates the files within hours of a plugin approval or stats refresh.

How are total downloads calculated? Total downloads are computed by summing all per-version download counts from the stats file. The special "latest" key (which is a version alias, not a separate count) is excluded from the sum.

Why is latest_version missing for some plugins? A small number of plugins appear in the plugin list but have no entry in the stats file (usually very newly added plugins). For these, latest_version is omitted from the output rather than populated with a null value.

Can I filter by author or specific plugin ID? Use the query field to filter by any text appearing in the plugin name, description, or author name. For example, "query": "blacksmithgu" returns all plugins by that author.

What is the maximum number of results? The maxItems field accepts up to 10,000. The full plugin catalog is approximately 1,700–1,800 entries; set maxItems to 2000 to ensure you get everything.

Does this actor require a proxy or cookies? No. GitHub raw content is publicly accessible with standard HTTP requests. No proxy, cookies, or API keys are needed.