The Modhold API

Read anything public with no key: search, a mod's page, its files, and vote totals for many mods in one call. Downloads need the player's own key, so every install counts for the mod's author, the same as a click on the mod's page. Answers are JSON and any site or local dashboard can call them (600 requests a minute).

Search

Sorts: updated, new, downloads, vouched, rising, name. Also tag=. 50 a page, page= for more.

One mod, with its files

Vote totals for a list of mods

Each mod gives vouches, score (0 to 10) and how many scored, watching, unique downloads, downloads and views.

Connect a player

The player signs in and says yes once. They are sent back to your return address with modhold_key, state and user. The return address has to be on their own computer (localhost), so a key never goes anywhere else. They can remove it any time.

Download a file as that player

Gives a link good for an hour, with the file's size and SHA-256. Check the SHA-256 before installing: it is the exact file our virus scan and staff checked.