# Colorfabb — 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.

> Access ColorFabb's full filament catalog, including material specifications, pricing, RAL color listings, and customer review ratings. Search and filter products by material type, color, and keyword to compare filaments across categories.

**Category:** E-commerce | **Website:** [colorfabb.com/](https://colorfabb.com/) | **Docs:** [parse.bot/marketplace/4482897d-55cc-4488-9ba5-4d684cfea5ea/colorfabb-com-api](https://parse.bot/marketplace/4482897d-55cc-4488-9ba5-4d684cfea5ea/colorfabb-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-colorfabb-com-api-4482897d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_filaments

Retrieve a paginated list of all filaments with basic details and configurations. Returns up to 12 products per page. Supports filtering by material category ID. Paginate by incrementing the page parameter until products array is empty or current_page exceeds total_count / 12.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `material` | string | No | Material category ID to filter by (e.g. '17285' for PLA High Speed Pro). IDs available from get_filament_categories endpoint. |
| `page` | integer | No | Page number (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-colorfabb-com-api-4482897d/get_all_filaments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"material":"<string>","page":"<integer>"}'
```

### get_filament_categories

List all filament material categories and their product counts. No parameters required. Returns category names, IDs (used as material filter in get_all_filaments), and item counts.

**Estimated cost:** Metered

_No parameters required._

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

### get_filament_detail

Retrieve full details for a single filament product by its URL slug, including name, SKU, description, specifications, and printing advice. Returns stale_input if the product slug does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product URL slug (e.g. 'varioshore-tpu-black', 'pla-high-speed-pro-natural'). |

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

### get_filament_reviews

Retrieve aggregate ratings for a specific product ID from the review provider. Returns total review count and average score. Product IDs are available from the id field in get_all_filaments or get_ral_colors results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Internal product entity ID (e.g. '9020', '1525'). Available from the id field in get_all_filaments or get_ral_colors results. |

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

### get_ral_colors

Retrieve all RAL color filaments with pagination. Returns up to 12 products per page. Each product includes name, price, stock status, and configuration options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-colorfabb-com-api-4482897d/get_ral_colors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_filaments

Search for filaments by keyword using the site's autocomplete search. Returns matching products with basic details including SKU, name, description, price, and URL. Results are not paginated; the response returns the top matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'PLA', 'TPU', 'black'). |

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