# MakerWorld 3D Models API

> MakerWorld 3D print models: search by keyword, model details, print profiles and trending searches

- Vendor: `makerworld3dmodelsapi` · version 1.0 · category Content · tags makerworld api, 3d models api, 3d printing api, bambu lab models api, stl search api, 3d print files api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/makerworld3dmodelsapi
- This document: https://apiclay.com/docs/makerworld3dmodelsapi.md
- OpenAPI 3.1: https://apiclay.com/api/makerworld3dmodelsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `makerworld3dmodelsapi`
- Updated: 2026-11-18

## About

## MakerWorld 3D Models API

The model library behind MakerWorld, Bambu Lab's 3D-printing community: search published models by keyword with likes, collections, prints, downloads, comments, creator, licence and cover image; open one model with its summary, tags, categories, creator, licence and its print profiles (plates, printer, filament weight and predicted print time); and read the trending and curated search words shown on the site.

Data comes from **makerworld.com** (https://makerworld.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?keyword=gear&amp;limit=20&amp;offset=0`, then `/design?id=` with a hit `id`.

### Routes

#### GET `/search` - Search models
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| keyword | query | string | yes | Search words, e.g. `gear` or `phone stand`. |
| limit | query | number | no | Results per page, e.g. 20. |
| offset | query | number | no | Results to skip, for paging. |
| orderBy | query | string | no | Sort, e.g. `downloadCount`, `likeCount`, `createTime` (default: relevance). |

Returns: `total` and `hits` array: `id`, `title`, `slug`, `cover`, `likeCount`, `collectionCount`, `printCount`, `downloadCount`, `commentCount`, `designCreator` (`uid`, `name`), `createTime`, `license`, `tags`, `isStaffPicked`, `nsfw`.

#### GET `/design` - Model
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Model `id` from `/search`. |

Returns: the model: `title`, `summary` (HTML), `coverUrl`, counts (`likeCount`, `downloadCount`, `printCount`, `commentCount`), `tags`, `categories`, `designCreator`, `license`, `nsfw`, and `instances` (print profiles with `title`, `summary`, `weight`, `prediction`, plates and printer). About 150 KB.

#### GET `/trending-searches` - Trending searches
No parameters.

Returns: `hotList.listWords` (trending search words) and `customList` (curated themes, each with `name` and `listWords`).

### Caveats

- Model files, images and descriptions belong to their creators under the licence shown on each model; this API returns metadata only, not the downloadable files.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by makerworld.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search models
- Gateway: `GET https://api.apiclay.com/v1/api/makerworld3dmodelsapi/search`
- Public query params: `keyword` (string, required), `limit` (number), `offset` (number), `orderBy` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /design — Model
- Gateway: `GET https://api.apiclay.com/v1/api/makerworld3dmodelsapi/design`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /trending-searches — Trending searches
- Gateway: `GET https://api.apiclay.com/v1/api/makerworld3dmodelsapi/trending-searches`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/makerworld3dmodelsapi/search?keyword=<keyword>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
