MakerWorld API — Parse a MakerWorld URL
Documentation menu
FetchLayer FetchLayer API

Parse a MakerWorld URL

Turn any MakerWorld URL into structured input: whether it points at a model, a designer, a collection, a contest or a search, plus the id, slug, model type and ordering it encodes. Parsing a URL does not consume a credit.

POST /resolve-url Utility
https://api.fetchlayer.dev/makerworld/resolve-url
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

url string required

Any MakerWorld URL, to be parsed into structured input.

timeoutMs number optional

Per-request time limit in milliseconds (max 600000).

format string optional

json or markdown. (default: json)

Response Fields

resolve-url

Parse a MakerWorld URL

kind string

What the URL points at: model, designer, collection, contest, search, or unknown.

modelId string

Present when kind is model.

handle string

Present when kind is designer.

collectionId string

Present when kind is collection.

contestId string

Present when kind is contest.

query string

Present when kind is search.

slug string

The slug that followed the id, if any.

modelType string

3d or laser, when the URL carries one.

sortBy string

Ordering the URL asks for, verbatim.

Request

curl -X POST "https://api.fetchlayer.dev/makerworld/resolve-url" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://makerworld.com/en/models/412809-under-desk-cable-tray"}'

Response

{
  "kind": "model",
  "modelId": "412809",
  "slug": "under-desk-cable-tray",
  "handle": null,
  "collectionId": null,
  "query": null
}