# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-myminifactory-com-api-4e75f034/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-myminifactory-com-api-4e75f034/get_object \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/get_object_comments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/get_trending_objects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/get_user \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/get_user_objects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/list_tribes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-myminifactory-com-api-4e75f034/search_objects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","query":"<string>","sort_by":"<string>"}'
```