Nexus Mods Scraper

Scrape Nexus Mods — the largest video game modding community, home to millions of mods across 4,900+ games including Skyrim, Fallout, Cyberpunk 2077, The Witcher 3, Stardew Valley, and Baldur's Gate 3. Search mods by keyword, fetch exact mod details by ID, list a mod's downloadable files and version history, see who endorsed a mod, browse the full games catalog, discover curated mod collections and see exactly which mods they bundle, read official news, and look up public modder profiles. No login, no API key, no cookies required.

What this actor does

• Search mods across any game with filters for category, tag, and adult content, sorted by downloads, endorsements, name, date, size, or randomly
• Fetch exact mod details for one or more mod IDs — full description, file size, download mirrors, uploader info, and tags
• List a mod's files — every uploaded version/file for a mod with changelog, size, download counts, and virus-scan status
• List a mod's archive contents — every individual file (ESP/ESL/BSA/DLL/texture/etc.) packed inside a mod's downloadable archive(s), with path and size, filterable by file extension
• List a mod's endorsers — every user who endorsed a mod, with their profile and the exact date they endorsed it
• List a mod's requirements/dependents — every mod and DLC a mod depends on, plus every mod that depends on it
• Browse the games catalog — 4,900+ supported games with mod counts, download totals, and genres
• Browse mod collections — curated "modpacks" built by the community, with ratings, badges, and download stats
• List a collection's mods — every mod bundled inside a specific collection revision, with per-mod version and optional/required flag
• List a collection's comments — every community comment posted on a collection's page, with likes, replies, and poster identity
• List a collection's changelog — every published-revision update note a curator has posted for a collection
• List a collection's bug reports — every community-reported issue for a collection, open or closed, with reporter identity and closure reason
• Browse official news — Nexus Mods site news, game news, interviews, competitions, and features
• Look up user profiles — public modder stats: kudos, mods authored, collections, join date
• Search users by name — find Nexus Mods members by partial username match, with the same public profile stats
• Browse valid tags for a game — discover the exact tag names to plug into search's tag filter
• Browse community media — screenshots and videos uploaded by players for a game, with captions, ratings, and view counts
• Identify a file by its MD5 hash — look up which mod/file a downloaded archive belongs to from its checksum, useful for verifying or tracing unlabeled downloads
• Empty fields are omitted — a record only contains the fields Nexus Mods could actually populate for it

Modes

Mode	What it fetches
search	Mods matching a text query and/or filters
modDetails	Exact mods by game + mod ID
modFiles	All downloadable files/versions for one or more mods
modFileContents	Every individual file packed inside one or more mods' archive(s)
modEndorsers	Every user who endorsed one or more mods
modRequirements	What one or more mods require (DLC + other mods) and/or what requires them
browseGames	The Nexus Mods games catalog
browseCollections	Curated mod collections for a game
collectionMods	The mods bundled inside a specific collection revision
collectionComments	Community comments posted on a collection's page
collectionChangelog	Published-revision update notes for a collection
collectionBugReports	Community-reported bugs for a collection
browseNews	Official Nexus Mods news articles
userProfile	A single user's public profile
searchUsers	Users matching a partial username query
browseTags	Valid mod/collection tags for a game
browseMedia	Community-uploaded screenshots/videos for a game
fileHashLookup	Identify mod file(s) matching one or more MD5 checksums

Output

Every record includes recordType, scrapedAt, and a canonical page URL. Fields that can't be populated for a given record are omitted (never null or empty).

Mod record (recordType: "mod")

modId, uid, name, summary, description, version, category, categoryId, status, createdAt, updatedAt, adultContent, author, downloads, endorsements, fileSizeKb, supportsVortex, directDownloadEnabled, blockedFromEarningPoints, legacyModRequirementsEnabled, pictureUrl, thumbnailUrl, thumbnailLargeUrl, thumbnailBlurredUrl, thumbnailLargeBlurredUrl, mirrors[] (name/url/totalDownloads), tags[], uploaderName, uploaderMemberId, uploaderAvatarUrl, gameId, gameDomainName, gameName, modUrl

Mod file record (recordType: "modFile")

fileId, name, version, category, description, changelogText[], uploadedAt, sizeKb, sizeBytes, totalDownloads, uniqueDownloads, archiveFileName, isPrimary, virusScanStatus, hasRequirementsAlert, fileGroupId, uploaderName, uploaderMemberId, modId, modName, gameDomainName, gameName, fileUrl, modUrl

Mod file content record (recordType: "modFileContent")

fileName, filePath, filePathParts[], fileExtension, fileSizeBytes, fileId, modId, modName, gameDomainName, gameName, modUrl, fileUrl

Mod endorser record (recordType: "modEndorser")

memberId, name, avatarUrl, endorsedAt, modId, modName, gameDomainName, gameName, modUrl, profileUrl

Mod requirement record (recordType: "modRequirement")

sourceModId, sourceModName, sourceModUrl, direction (requires / requiredBy), requirementType (mod / dlc), relatedName, relatedModId, relatedModUrl (mod-type only), isExternal (mod-type only — whether the requirement is hosted off Nexus, e.g. a third-party tool), notes, externalUrl (mod-type only, when the requirement links off-site), gameDomainName, gameName

Game record (recordType: "game")

gameId, name, domainName, genre, modCount, collectionCount, imageCount, mediaCount, videoCount, downloadCount, uniqueDownloadCount, supportsVortex, copyrightedName, trendingPeriodDays, forumUrl, approvedAt, gameUrl

Collection record (recordType: "collection")

collectionId, slug, name, summary, description (longer markdown write-up; may repeat summary for short collections), endorsements, totalDownloads, uniqueDownloads, overallRating, overallRatingCount, recentRating, recentRatingCount, collectionStatus, allowUserMedia, categoryName, tags[], badges[], gameId, gameDomainName, gameName, authorName, authorMemberId, authorAvatarUrl, editors[] (co-authors with permission to edit the collection, deduplicated; omitted when there are none besides the primary author), headerImageUrl, tileImageUrl, latestPublishedRevisionNumber, modCount (mod count in the latest published revision), totalSizeBytes (total archive size in bytes for the latest published revision), createdAt, updatedAt, firstPublishedAt, lastPublishedAt, collectionUrl

Collection mod record (recordType: "collectionMod")

collectionSlug, collectionRevisionNumber, optional, updatePolicy, version, fileId, fileName, sizeKb, sizeBytes, fileTotalDownloads, fileUniqueDownloads, modId, modName, modSummary, modCategory, modAdultContent, modAuthor, gameDomainName, gameName, modUrl, collectionUrl

Collection comment record (recordType: "collectionComment")

commentId, body, createdAt, updatedAt, likesCount, isPinned, isReply, parentCommentId (only when isReply is true), creatorName, creatorMemberId, creatorAvatarUrl, creatorProfileUrl, collectionSlug, collectionName, gameDomainName, gameName, collectionUrl

Collection changelog record (recordType: "collectionChangelog")

changelogId, revisionNumber, collectionRevisionId, description, createdAt, updatedAt, collectionSlug, collectionName, gameDomainName, gameName, collectionUrl

Collection bug report record (recordType: "collectionBugReport")

bugReportId, title, description, status (open / closed), collectionRevisionNumber, createdAt, updatedAt, closedAt, closureReason (resolved / not_a_bug / wont_fix, only when set), attachmentUrls[], reporterName, reporterMemberId, reporterAvatarUrl, reporterProfileUrl, collectionSlug, collectionName, gameDomainName, gameName, collectionUrl

News record (recordType: "news")

newsId, title, summary, content, isHtml, date, commentsCount, categoryName, authorName, authorMemberId, authorAvatarUrl, imageUrl, headerImageUrl, sourceName, sourceUrl, newsUrl

User record (recordType: "user")

memberId, name, avatarUrl, about, country, joined, lastActive, kudos, endorsementsGiven, modCount, ownedModCount, contributedModCount, collectionCount, imageCount, videoCount, posts, views, recognizedAuthor, donationsEnabled, hasGivenKudos, banned, deleted, membershipRoles[], uniqueModDownloads, roles[], legacyRoles[], profileUrl

Tag record (recordType: "tag")

tagId, name, isAdult, isGlobal, taggablesCount (number of mods/collections carrying this tag), categoryName, gameDomainName

Media record (recordType: "media")

mediaId, mediaType (image / video / supporterImage), title, caption (images only), description, mediaUrl, thumbnailUrl, siteUrl, isAdultContent (images only), views, rating, createdAt, categoryName, ownerName, ownerMemberId, gameId, gameDomainName, gameName

File hash record (recordType: "fileHash")

md5, fileName, fileSizeBytes, fileType, createdAt, gameId, fileId, version, sizeKb, modFileSizeBytes, totalDownloads, uniqueDownloads, category, modId, modName, gameDomainName, gameName, modUrl, fileUrl (fileId/version/sizeKb/modFileSizeBytes/totalDownloads/uniqueDownloads/category/modId/modName/gameDomainName/gameName/modUrl/fileUrl are only populated when Nexus Mods could resolve the matched file to a live mod/file record)

Input

Field	Type	Applies to	Description
mode	select	all	search / modDetails / modFiles / modFileContents / modEndorsers / modRequirements / browseGames / browseCollections / collectionMods / collectionComments / collectionChangelog / collectionBugReports / browseNews / userProfile / searchUsers / browseTags / browseMedia / fileHashLookup
searchQuery	string	search	Free-text query matched against mod names
gameDomainName	string	search, modDetails, modFiles, modFileContents, modEndorsers, modRequirements, browseCollections, collectionMods, collectionComments, browseNews, browseTags, browseMedia	Game slug, e.g. skyrimspecialedition, fallout4, cyberpunk2077
modIds	array	modDetails, modFiles, modFileContents, modEndorsers, modRequirements	Numeric mod IDs to fetch
fileExtensionFilter	string	modFileContents	Exact file extension to restrict the archive listing to, e.g. .esp, .bsa, .dll (leading dot optional)
requirementDirection	select	modRequirements	all / requires / requiredBy — which side of the dependency relationship to return
category	string	search	Exact mod category, e.g. Armour, Weapons, Overhauls
tag	string	search	Exact mod tag, e.g. Overhaul, Quality of Life, Cheating
author	string	search	Restrict results to mods credited to this author/uploader name
languageName	string	search	Restrict results to mods tagged with this translation language, e.g. Russian, German
minDownloads	integer	search	Only return mods with at least this many total downloads
minEndorsements	integer	search	Only return mods with at least this many endorsements
supportsVortexFilter	select	search	any / vortexOnly / nonVortexOnly — restrict by Vortex mod-manager support
minFileSizeKb	integer	search	Only return mods whose primary file size is at least this many kilobytes
maxFileSizeKb	integer	search	Only return mods whose primary file size is at most this many kilobytes
directDownloadFilter	select	search	any / directDownloadOnly / nonDirectDownloadOnly — restrict by direct-download API support
adultContentFilter	select	search, browseCollections, browseMedia	includeAdult / excludeAdult / onlyAdult
sortBy	select	search	relevance / downloads / uniqueDownloads / endorsements / name / createdAt / updatedAt / size / random / lastComment
sortDirection	select	search, browseGames, browseCollections, browseMedia, collectionComments, searchUsers	ASC / DESC
gameNameQuery	string	browseGames	Free-text filter on game name
browseGamesSortBy	select	browseGames	mods / downloads / collections / name / approved / relevance
collectionCategory	select	browseCollections	Total Overhaul / Vanilla Plus / Themed / Essentials / Miscellaneous
collectionTag	string	browseCollections	Exact collection tag, e.g. Environment, Gameplay, Bug Fixes, Quality of Life
browseCollectionsSortBy	select	browseCollections	relevance / createdAt / updatedAt / endorsements / downloads / rating / recentRating
collectionSlug	string	collectionMods, collectionComments, collectionChangelog, collectionBugReports	Collection slug to list mods/comments/changelog/bug reports for, e.g. rqhcxy
collectionRevisionNumber	integer	collectionMods	Exact revision to fetch; leave blank for the current published revision
collectionCommentsSortBy	select	collectionComments	createdAt / likesCount
bugReportStatusFilter	select	collectionBugReports	open / closed / all — which bug reports to return
newsCategory	select	browseNews	all / SITE_NEWS / GAME_NEWS / MOD_NEWS / INTERVIEWS / COMPETITIONS / FEATURES
username	string	userProfile	Exact Nexus Mods username
memberId	integer	userProfile	Exact numeric member ID (takes priority over username)
userSearchQuery	string	searchUsers	Free-text partial-match query against usernames (2+ characters)
searchUsersSortBy	select	searchUsers	relevance / name
mediaSearchQuery	string	browseMedia	Free-text query matched against screenshot/video captions and descriptions
mediaTypeFilter	select	browseMedia	any / image / video — restrict to only screenshots or only videos
browseMediaSortBy	select	browseMedia	createdAt / views / rating / random
md5Hashes	array	fileHashLookup	One or more 32-character hex MD5 checksums to identify matching mod file(s)
maxItems	integer	all	Hard cap on emitted records (1–500)

Example: search mods

{
  "mode": "search",
  "gameDomainName": "skyrimspecialedition",
  "searchQuery": "survival",
  "sortBy": "endorsements",
  "maxItems": 20
}

Example: exact mod lookup

{
  "mode": "modDetails",
  "gameDomainName": "skyrimspecialedition",
  "modIds": ["671", "17729"]
}

Example: a mod's file/version history

{
  "mode": "modFiles",
  "gameDomainName": "skyrimspecialedition",
  "modIds": ["671"]
}

Example: a mod's archive file listing

{
  "mode": "modFileContents",
  "gameDomainName": "skyrimspecialedition",
  "modIds": ["671"],
  "fileExtensionFilter": ".esp"
}

Example: a mod's endorsers

{
  "mode": "modEndorsers",
  "gameDomainName": "skyrimspecialedition",
  "modIds": ["671"],
  "maxItems": 50
}

Example: a mod's requirements and dependents

{
  "mode": "modRequirements",
  "gameDomainName": "skyrimspecialedition",
  "modIds": ["12604"],
  "requirementDirection": "all",
  "maxItems": 30
}

Example: browse a game's top collections

{
  "mode": "browseCollections",
  "gameDomainName": "fallout4",
  "browseCollectionsSortBy": "endorsements",
  "maxItems": 25
}

Example: mods bundled inside a collection

{
  "mode": "collectionMods",
  "collectionSlug": "rqhcxy"
}

Example: a collection's community comments

{
  "mode": "collectionComments",
  "collectionSlug": "rqhcxy",
  "collectionCommentsSortBy": "createdAt",
  "sortDirection": "DESC",
  "maxItems": 20
}

Example: a collection's changelog

{
  "mode": "collectionChangelog",
  "collectionSlug": "rqhcxy",
  "maxItems": 20
}

Example: a collection's open bug reports

{
  "mode": "collectionBugReports",
  "collectionSlug": "rqhcxy",
  "bugReportStatusFilter": "open",
  "maxItems": 20
}

Example: latest interviews

{
  "mode": "browseNews",
  "newsCategory": "INTERVIEWS",
  "maxItems": 10
}

Example: user profile

{
  "mode": "userProfile",
  "username": "Chesko"
}

Example: search users by partial name

{
  "mode": "searchUsers",
  "userSearchQuery": "chesko",
  "maxItems": 10
}

Example: discover valid tags for a game

{
  "mode": "browseTags",
  "gameDomainName": "skyrimspecialedition"
}

Example: search with author, minimum downloads, and language filters

{
  "mode": "search",
  "gameDomainName": "skyrimspecialedition",
  "author": "Chesko",
  "minDownloads": 100000,
  "languageName": "Russian"
}

Example: community screenshots for a game

{
  "mode": "browseMedia",
  "gameDomainName": "skyrimspecialedition",
  "mediaSearchQuery": "armor",
  "browseMediaSortBy": "rating",
  "maxItems": 20
}

Example: identify a file by MD5 hash

{
  "mode": "fileHashLookup",
  "md5Hashes": ["d41d8cd98f00b204e9800998ecf8427e"],
  "maxItems": 20
}

Use cases

• Modding tool integrations — build mod-list managers, update checkers, or compatibility trackers
• Conflict/compatibility checks — inspect a mod's archive contents (modFileContents) to see exactly which ESP/BSA/texture files it packs before installing
• Community dashboards — track a game's most-endorsed or most-downloaded mods over time
• Content discovery — surface trending mods, collections, or news for a specific game
• Research & analytics — study modding trends across genres, tags, and games
• Creator tools — monitor a mod author's or collection curator's public stats

FAQ

Do I need a Nexus Mods account or API key? No. This actor uses Nexus Mods' public data endpoint — the same one that powers the website's own search and browse pages. No login, API key, or cookies are required.

How do I find a game's gameDomainName? It's the slug in the game's Nexus Mods URL: nexusmods.com/<domainName>. For example, Skyrim Special Edition is skyrimspecialedition, Fallout 4 is fallout4, Cyberpunk 2077 is cyberpunk2077.

How do I find a mod's ID? It's the number at the end of a mod page URL, e.g. 671 from nexusmods.com/skyrimspecialedition/mods/671.

Are category and tag filters case-sensitive? They must match Nexus Mods' exact label for that game (e.g. Armour, not armour). Check a game's mod-browse page for its exact category names, or run mode=browseTags for a game to get the exact list of valid tag names.

Can I fetch adult-only (18+) content? Yes — set adultContentFilter to includeAdult (default, shows everything) or onlyAdult to fetch only adult-tagged mods. Use excludeAdult to filter it out entirely.

Why is description sometimes long or contain formatting markup? Mod descriptions are authored in Nexus Mods' own BBCode-like markup (e.g. [b]bold[/b], [url=...]). The actor returns the raw authored text as-is.

Does this actor cover every game on Nexus Mods? Yes — browseGames lists the full catalog (4,900+ games), and search/modDetails/browseCollections/browseNews accept any valid gameDomainName from that catalog.

What's the difference between collectionChangelog and collectionComments? collectionChangelog is the curator's own official update notes for each published revision (what changed and why). collectionComments is unrelated community discussion posted on the collection's page.

What's the difference between userProfile and searchUsers? userProfile looks up one exact user by their exact username or numeric memberId. searchUsers finds every member whose username contains a given text fragment (e.g. userSearchQuery: "chesko" matches Chesko, BOCHESKO, CHESKO91, etc.) — use it when you don't know a member's exact username.

What can I do with fileHashLookup? Given the MD5 checksum of a file (e.g. one you downloaded from somewhere else, or found unlabeled on disk), it identifies every mod file on Nexus Mods sharing that exact checksum — useful for tracing an unknown archive back to its source mod, or verifying a download matches the official upload.

Is this affiliated with Nexus Mods? No, this is a third-party actor using Nexus Mods' public data endpoint. It is not affiliated with, endorsed by, or sponsored by Nexus Mods.

Limitations

• Private/authenticated fields (email addresses, IP addresses, moderation history) are never exposed — only public profile data is returned for userProfile.
• Mod page URLs (modUrl, fileUrl, gameUrl, collectionUrl, newsUrl, profileUrl, siteUrl) are standard browser links to nexusmods.com; they are not fetched by this actor and are provided for reference/click-through only. nexusmods.com sits behind a Cloudflare JS challenge, so these links return a 403 to non-browser tools like curl or server-side fetchers — they load normally in any real browser. Media URLs (pictureUrl, thumbnailUrl, headerImageUrl, tileImageUrl, imageUrl, avatarUrl, mediaUrl) are served from staticdelivery.nexusmods.com, which has no such challenge and is directly fetchable.
• browseMedia results are user-generated screenshots/videos; caption/description/isAdultContent are only populated for image uploads (Nexus Mods' schema does not expose an adult flag for videos), and caption is omitted entirely for videos since the underlying field doesn't exist on that type.
• mode=modRequirements DLC-type records (requirementType: "dlc") never have relatedModId/relatedModUrl/isExternal — a DLC/game-expansion requirement isn't a mod, so only relatedName (the expansion's name, e.g. Far Harbor) and optionally notes are populated for those records.
• searchQuery (mode=search) and gameNameQuery (mode=browseGames) must be at least 2 characters — Nexus Mods' API rejects shorter values outright, so single-character queries are ignored (other filters/sort still apply, or the full catalog/game's mods are browsed unfiltered). mediaSearchQuery (mode=browseMedia) has no such minimum.
• mode=collectionComments only covers comments on collection pages — Nexus Mods' public data API does not expose a comparable comment thread for individual mod pages, so there is no equivalent modComments mode.
• mode=collectionBugReports with bugReportStatusFilter: "all" issues one request for open and one for closed and merges them (Nexus Mods' API requires an exact status per request, with no combined option) — the open batch is always emitted first.
• mode=collectionChangelog/collectionBugReports require collectionSlug; gameDomainName is optional context for both (same as collectionMods/collectionComments) since the slug alone already identifies the collection.
• mode=fileHashLookup can return multiple matching files for one hash — an MD5 checksum is not unique to a single mod file (unrelated uploads can legitimately share identical content, e.g. an empty file, a duplicate re-upload, or a shared readme); every match is returned as a separate fileHash record. Invalid entries in md5Hashes (wrong length or non-hex characters) are silently dropped before the request is made.
• mode=collectionMods cannot fetch the mod list of a collection that is flagged adult-only (18+) — Nexus Mods' API blocks that specific lookup for anonymous (non-logged-in) requests regardless of collectionRevisionNumber, even though the same collection still appears normally in browseCollections listings and its comments/changelog/bug reports remain fetchable. The actor detects this and reports it clearly via the run's status message rather than a misleading "not found".