MakerWorld API — Getting Started — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Getting Started

Search MakerWorld in two steps, then follow a model through to its print profiles.

1. Get your API key

Create an account and generate a FetchLayer API key from your dashboard. No MakerWorld login, Bambu Lab account, or OAuth flow is involved.

Create free account →

2. Search for models

bash
curl -X POST https://api.fetchlayer.dev/makerworld/search-models \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"cable management","sortBy":"trending","printableOnly":true,"limit":30}'

Tip

Already have a MakerWorld URL? Send it to /resolve-url first — it tells you whether it points at a model, a designer, a collection, a contest or a search, and hands back the id to use. It does not consume a credit.

3. Follow a model to its print profiles

Every result carries a modelId. Pass it to /model-detail for the file manifest, remix lineage, and every published print profile with its printer, nozzle size, print time and filament use.

bash
curl -X POST https://api.fetchlayer.dev/makerworld/model-detail \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"412809","printProfileLimit":20}'

4. Always read notes

Every JSON response carries a notes array. It is empty when the result is complete, and carries a plain-English string when it is not — a page walk that stopped early, a print-profile list truncated by printProfileLimit, or a listing MakerWorld itself cut short. Treat a non-empty notes as a signal to raise pages or page on with cursor.

json
{
  "modelCount": 100,
  "hasNextPage": true,
  "nextCursor": "eyJwYWdlIjoy...",
  "notes": [
    "Stopped after 1 page; more results are available."
  ]
}

No designer catalogue

MakerWorld does not publish the full list of a designer's models, and no route here can scope a model search to one designer. /designer-profile gives you their lifetime counts and their pinned showcase — not everything they have made.

Next steps