Greasy Fork Userscripts Scraper

Scrape Greasy Fork (greasyfork.org) - the web's largest userscript marketplace, home to tens of thousands of Tampermonkey/Violentmonkey/Greasemonkey scripts. Search by keyword, browse every userscript for a specific website, browse reusable code libraries, or pull full details (target sites, license, install count, ratings) for specific scripts by ID or URL.

What this actor does

• Five modes: search, bySite, libraries, byScriptIds, byAuthor
• Search by keyword across script names and descriptions
• Browse by target website - every userscript that runs on a given domain
• Browse code libraries - shared code other userscripts depend on
• Browse by author - every userscript published by a specific Greasy Fork user
• Full script detail lookup - target sites, license, code size, long description
• Sort by relevance, total installs, ratings, created date, updated date, or name
• Empty fields are omitted - a field only appears when Greasy Fork actually shows it

Output: userscripts (mode = search / bySite / libraries)

• scriptId, name, description
• authors[], primaryAuthor, authorIds[]
• language - source language (js for nearly all userscripts)
• scriptType - public or library
• version
• dailyInstalls, totalInstalls
• ratingScore, ratingGoodCount, ratingOkCount, ratingBadCount
• isSensitive - Greasy Fork's mature-content flag
• createdDate, updatedDate
• installUrl - direct .user.js install link
• detailUrl, sourceUrl
• recordType: "script", scrapedAt

Output: script detail (mode = byScriptIds)

All of the above fields (except language/scriptType/isSensitive, not shown on the detail page), plus:

• longDescription - the script's full README/description
• appliesTo[] - target website domains
• license, licenseUrl
• codeSize - e.g. 64.5 KB
• namespace
• feedbackCount - number of reviews/discussion posts
• recordType: "scriptDetail", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / bySite / libraries / byScriptIds / byAuthor
searchQuery	string	youtube	Keyword search (mode=search)
site	string	-	Target website domain, e.g. youtube.com (mode=bySite)
authorId	string	-	Author numeric user ID or profile URL, e.g. 1 or https://greasyfork.org/en/users/1-username (mode=byAuthor)
sortBy	string	relevance	relevance / totalInstalls / ratings / created / updated / name (not honored for byAuthor)
excludeSensitive	boolean	false	Skip mature/sensitive-flagged scripts
minTotalInstalls	int	-	Drop scripts with fewer lifetime installs
scriptIds	array	-	Script IDs or URLs to look up (mode=byScriptIds)
maxItems	int	30	Hard cap on emitted records (1-500)

Example: search by keyword

{
  "mode": "search",
  "searchQuery": "dark mode",
  "sortBy": "totalInstalls",
  "maxItems": 30
}

Example: every userscript for a website

{
  "mode": "bySite",
  "site": "github.com",
  "sortBy": "ratings",
  "maxItems": 50
}

Example: full detail for specific scripts

{
  "mode": "byScriptIds",
  "scriptIds": ["406540", "https://greasyfork.org/en/scripts/563321-all-in-one-video-downloader-hd-youtube-tiktok-instagram-x-more"]
}

Example: browse popular code libraries

{
  "mode": "libraries",
  "sortBy": "totalInstalls",
  "maxItems": 20
}

Example: every script by a specific author

{
  "mode": "byAuthor",
  "authorId": "1",
  "sortBy": "updated",
  "maxItems": 30
}

Use cases

• Browser extension developers - discover popular userscripts for a target site before building a competing feature
• Security research - audit widely-installed scripts for a given website by install count and rating
• Tooling curation - build a "best userscripts for X" directory or newsletter
• Trend tracking - monitor sortBy=updated/created to see what's actively maintained
• Dependency research - browse libraries mode to find reusable code other scripts build on

FAQ

What is the data source? Greasy Fork's own public script listing and detail pages (greasyfork.org). No login required.

What's the difference between search and bySite? search matches a free-text keyword against script names/descriptions. bySite returns every userscript that declares it runs on a specific website, regardless of name/description match.

What are "libraries"? Greasy Fork also hosts reusable JavaScript libraries that other userscripts @require - shared code rather than standalone scripts a user installs directly.

Why is ratingScore sometimes slightly different between list and detail modes? List pages expose Greasy Fork's own precomputed relevance-adjusted score. Detail mode (which doesn't expose that score directly) derives an equivalent score from the visible good/OK/bad rating counts. Both describe the same underlying ratings.

Why do some scripts have no appliesTo? Only byScriptIds (detail) mode returns target sites - the list pages this actor uses for search/bySite/libraries/byAuthor don't expose that field per row, only on the individual script page.

Does sortBy work with byAuthor? No - Greasy Fork's user-profile page (/en/users/{id}) ignores the sort query parameter entirely and always returns that author's scripts in its own fixed default order, unlike search/bySite/libraries (all three genuinely honor sortBy). byAuthor still returns every script by that author with complete, correct data - only the ordering can't be controlled.

Is this affiliated with Greasy Fork? No - this is an independent, third-party actor built on Greasy Fork's publicly accessible pages.

Are there rate limits? The actor uses polite delays between page loads. maxItems above ~200 will take longer since Greasy Fork paginates at 100 results per page.