# Myminifactory — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse 3D models on MyMiniFactory, discover trending designs, explore user collections and categories, and read community comments. Find exactly what you need by searching objects, viewing user profiles, and checking out popular content in real-time.

**Category:** Marketplaces | **Website:** [myminifactory.com/](https://myminifactory.com/) | **Docs:** [parse.bot/marketplace/4e75f034-2d7c-4ee3-a1f4-2453244228d6/myminifactory-com-api](https://parse.bot/marketplace/4e75f034-2d7c-4ee3-a1f4-2453244228d6/myminifactory-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/myminifactory/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get object

Retrieve full details for a single 3D model by its numeric ID. Returns comprehensive data including description, images, tags, categories, file metadata, community prints, and designer info. Returns input_not_found for non-existent IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `object_id` | string | Yes | The numeric ID of the 3D object (e.g. '443150'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/get-object \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"object_id":"<string>"}'
```

### Get object comments

Retrieve paginated comments for a specific 3D model. Returns items array and total_count. Many objects have zero comments, in which case items is empty and total_count is 0.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `object_id` | string | Yes | The numeric ID of the 3D object (e.g. '443150'). |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of comments per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/get-object-comments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"object_id":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### Get trending objects

Retrieve the list of currently trending 3D models. Returns paginated results sorted by trending score. Uses the search API with trending sort and no query filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of objects per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/get-trending-objects \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```

### Get user

Retrieve a user's public profile by username. Returns user details including bio, follower/following counts, object count, and social network links. Returns input_not_found for non-existent usernames.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | The username of the MyMiniFactory account (e.g. 'CraftyKid3D'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/get-user \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### Get user objects

Retrieve a paginated list of 3D models uploaded by a specific user. Returns items array and total count. Each item is an object summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of objects per page. |
| `username` | string | Yes | The username of the MyMiniFactory account (e.g. 'CraftyKid3D'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/get-user-objects \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","username":"<string>"}'
```

### List categories

Retrieve the full hierarchical list of all categories in a single response. Each category includes nested children. No pagination needed as all categories are returned at once.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List tribes

Retrieve a paginated list of recent creator subscription service (Tribes) posts. Returns an items array of post objects including title, body HTML, tags, cover image, and creator username.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of posts per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/list-tribes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```

### Search objects

Full-text search over 3D printable models. query matches object names, descriptions, and tags. Results are paginated and sortable. Omitting query returns all public objects. Each result is a summary; use get_object for full details including file info and prints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page. |
| `query` | string | No | Search keyword (e.g. 'dragon', 'miniature'). Omitting returns all objects. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/myminifactory/search-objects \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","query":"<string>","sort_by":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.