Skip to content

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
/builds

Public builds. ?game, ?sort=new|popular|updated, pagination.

/builds/{id}

One build with its full configuration (build_data) and videos.

/games

Every game on Loadset.

/games/{slug}

A game, its entity types and official links.

/games/{slug}/builds

Public builds for one game.

/games/{slug}/entities?type=

Catalog entities (fruits, units, weapons…) of one type.

/creators/{username}

A creator's public profile.

/creators/{username}/builds

A creator's public builds.

/search?q=

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

Usage policy

  • Free for any use that respects the Terms.
  • Credit the creator and link to the build's Loadset url wherever 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.