MakerWorld API — Model Category Tree
Documentation menu
FetchLayer FetchLayer API

List model categories

Return the MakerWorld category tree. Each node carries the category id that the `categories` filter on a model search takes, plus its name, slug, description, image and child categories. Call it once and cache it — the tree changes rarely.

POST /categories Discovery
https://api.fetchlayer.dev/makerworld/categories
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

timeoutMs number optional

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

format string optional

json or markdown. (default: json)

Response Fields

categories

List model categories

categories object[]

Top-level category nodes.

categories[].categoryId string

The id to pass in the categories filter on /search-models.

categories[].name string

Display name.

categories[].slug string

URL slug MakerWorld uses for the category.

categories[].children object[]

Child categories, same shape, nested.

categoryCount number

Number of categories in this response.

notes string[]

Caveats about this specific result — a walk that stopped early, a listing MakerWorld truncated, an upstream ceiling that was hit. Read it: an empty array means the result is complete, a non-empty one means it is not.

requestedUrl string

The MakerWorld page this result corresponds to.

scrapedAt string

ISO timestamp of when the data was retrieved.

blocked boolean

Always false on a successful response.

Request

curl -X POST "https://api.fetchlayer.dev/makerworld/categories" \
  -H "Authorization: Bearer ss-your-key"

Response

{
  "categoryCount": 12,
  "notes": [],
  "categories": [
    {
      "categoryId": "4",
      "name": "Household",
      "slug": "household",
      "children": [
        {
          "categoryId": "41",
          "name": "Organisation",
          "slug": "organization"
        }
      ]
    }
  ]
}