# Cults3d — 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 discover 3D printable models across Cults3D's marketplace, filtering by categories and sorting by popularity metrics like downloads, views, and likes. Access detailed information about specific creations, designer profiles, and engagement data to find the perfect models for your printing projects.

**Category:** Marketplaces | **Website:** [cults3d.com/](https://cults3d.com/) | **Docs:** [parse.bot/marketplace/a1183188-7520-462e-ada6-1cd078be1449/cults3d-com-api](https://parse.bot/marketplace/a1183188-7520-462e-ada6-1cd078be1449/cults3d-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-cults3d-com-api-a1183188/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

List all top-level categories available on the platform. Returns a fixed set of categories (Art, Fashion, Jewelry, Home, Architecture, Gadget, Game, Tool, Various) each with a name and slug usable for filtering in get_creations_batch.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cults3d-com-api-a1183188/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_creation_detail

Fetch comprehensive details for a single 3D model by its slug. Returns full metadata including tags, license, illustration images, comments, makes, and printing details. The slug is obtained from search_creations or get_creations_batch results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The creation's URL slug (from search_creations results[*].slug or get_creations_batch results[*].slug). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cults3d-com-api-a1183188/get_creation_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_creations_batch

Browse collections of creations with filtering and sorting. Supports category filtering by slug, price filtering (free or paid only), editor's picks, and multiple sort orders. Returns the same creation shape as search_creations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | No | Filter by category slug (from get_categories results, e.g. 'art', 'game', 'home'). |
| `limit` | integer | No | Maximum number of results to return (max 100). |
| `only_free` | boolean | No | When true, only return free models. |
| `only_priced` | boolean | No | When true, only return paid models. |
| `selected` | boolean | No | When true, only return editor's picks. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cults3d-com-api-a1183188/get_creations_batch \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","limit":"<integer>","only_free":"<boolean>","only_priced":"<boolean>","selected":"<boolean>","sort":"<string>"}'
```

### get_creator_profile

Fetch a designer/creator's profile including biography, follower counts, and their 10 most recent creations. The nick is obtained from search_creations or get_creation_detail results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `nick` | string | Yes | Creator's nickname/username (from search_creations results[*].creator.nick or get_creation_detail data.creator.nick). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cults3d-com-api-a1183188/get_creator_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nick":"<string>"}'
```

### search_creations

Full-text search over all 3D models on the platform. Matches against creation names, descriptions, and tags. Returns results sorted by relevance. Each result includes basic metadata (name, slug, price, creator, category, stats). Use the slug from results to fetch full details via get_creation_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (max 100). |
| `query` | string | Yes | Search keyword (e.g. 'dragon', 'vase', 'miniature'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cults3d-com-api-a1183188/search_creations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```