Developers
Use public Loadset builds on your own site: a free read-only JSON API, embeddable build cards and RSS feeds. No account or key needed.
Public API (v1)
Base URL https://loadset.net/api/v1. Every response is JSON: { data, pagination? } or { error: { code, message } }. The machine-readable spec is openapi.json (OpenAPI 3.1).
| GET | Returns |
|---|---|
/buildsPublic builds. ?game, ?sort=new|popular|updated, pagination. | Public builds. ?game, ?sort=new|popular|updated, pagination. |
/builds/{id}One build with its full configuration (build_data) and videos. | One build with its full configuration (build_data) and videos. |
/gamesEvery game on Loadset. | Every game on Loadset. |
/games/{slug}A game, its entity types and official links. | A game, its entity types and official links. |
/games/{slug}/buildsPublic builds for one game. | Public builds for one game. |
/games/{slug}/entities?type=Catalog entities (fruits, units, weapons…) of one type. | Catalog entities (fruits, units, weapons…) of one type. |
/creators/{username}A creator's public profile. | A creator's public profile. |
/creators/{username}/buildsA creator's public builds. | A creator's public builds. |
/search?q=Games, builds, creators and entities (10 each). | Games, builds, creators and entities (10 each). |
Example
curl "https://loadset.net/api/v1/games/blox-fruits/builds?sort=popular&per_page=5"
{
"data": [
{
"id": "…",
"title": "…",
"game": { "slug": "blox-fruits", "name": "Blox Fruits" },
"creator": { "username": "…", "url": "https://loadset.net/u/…" },
"stats": { "likes": 0, "saves": 0, "views": 0, "remixes": 0 },
"url": "https://loadset.net/games/blox-fruits/builds/…",
"embed_url": "https://loadset.net/embed/builds/…"
}
],
"pagination": { "page": 1, "per_page": 5, "has_next": true }
}Pagination: ?page= (1–200) and ?per_page= (1–50, default 20). Use pagination.has_next or the Link header.
Errors: 400 bad_request, 404 not_found (also for anything not public), 429 rate_limited, 503 unavailable.
Versioning: the version is in the path. Fields may be added to v1; nothing is removed or renamed without a new version.
Try it
Limits & caching
120 requests per 60 seconds per client. Every response carries X-RateLimit-Limit; a 429 includes Retry-After.
Responses are cached at the edge for 5–60 minutes and carry an ETag. Send If-None-Match to get a cheap 304. CORS is open for GET, so the API works from browser code.
Embeds
Every public build has a lightweight card you can iframe (no scripts, no cookies). Use the Share → Embed button on any build, or:
<iframe src="https://loadset.net/embed/builds/BUILD_ID" width="100%" height="190" style="max-width:560px;border:0;border-radius:12px" loading="lazy"></iframe>
Options: ?theme=light, ?size=compact. Creator cards: /embed/creators/USERNAME.
RSS & JSON feeds
- /feeds/builds.xml — newest public builds (also JSON Feed)
/feeds/games/GAME.xml— e.g. blox-fruits.xml/feeds/creators/USERNAME.xml
Usage policy
- Free for any use that respects the Terms.
- Credit the creator and link to the build's Loadset
urlwherever you show it. - Cache responses; don't poll faster than you need.
- Don't use the API to imply a creator endorses your site, or to rehost builds as your own.
- Read-only: there is no write access or account data.