# Pluginboutique — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 thousands of audio plugins across categories, brands, and deals, while discovering free products, new arrivals, and bundle offers. Get detailed information about specific plugins and find exactly what you need for your music production setup.

**Category:** Music | **Website:** [pluginboutique.com/](https://pluginboutique.com/) | **Docs:** [parse.bot/marketplace/f3670364-3c6e-4801-bfe0-5155d608325e/pluginboutique-com-api](https://parse.bot/marketplace/f3670364-3c6e-4801-bfe0-5155d608325e/pluginboutique-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/pluginboutique/`
**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 brand products

Get products from a specific brand/manufacturer. Returns paginated product listings for the given brand. Brand IDs can be obtained from the list_brands endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_id` | string | Yes | Brand ID (from list_brands results). |
| `brand_name` | string | No | Brand name used in URL construction. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pluginboutique/get-brand-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"<string>","brand_name":"<string>","page":"<integer>"}'
```

### Get product details

Get detailed information for a specific product by its full URL. Returns product name, manufacturer, price, rating, description text, feature list, and system requirements. The URL can be obtained from any product listing endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product page URL (e.g., 'https://www.pluginboutique.com/product/2-Effects/17-Reverb/915-Oxford-Reverb'). |

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

### List brands

List all plugin manufacturers/brands available on Plugin Boutique. Returns the complete alphabetical list of brands with their IDs, names, and profile URLs in a single response.

**Estimated cost:** Metered

_No parameters required._

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

### List bundles

List plugin bundles available on Plugin Boutique. Returns paginated results from the Bundles category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### List deals

List current deals and discounted products on Plugin Boutique. Returns paginated product listings that are currently on sale.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### List free products

List free audio plugins available on Plugin Boutique. Returns paginated results from the Effects category filtered to free products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### List new arrivals

List newest product arrivals on Plugin Boutique. Returns paginated results from the Effects category sorted by newest.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### List products by category

List products by category ID with optional filters and sorting. Returns paginated product listings for the specified category. Supports filtering by free, deals, bundles and sorting by hot, popularity, rating, newest, price_asc, price_desc.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bundles` | boolean | No | Filter for bundles. |
| `category_id` | string | Yes | Category ID: '1' for Instruments, '2' for Effects, '3' for Studio Tools, '81' for Bundles. |
| `category_name` | string | No | Category name used in URL construction (e.g., 'Effects', 'Instruments'). |
| `deals` | boolean | No | Filter for products on deal. |
| `free` | boolean | No | Filter for free products only. |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pluginboutique/list-products-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bundles":"<boolean>","category_id":"<string>","category_name":"<string>","deals":"<boolean>","free":"<boolean>","page":"<integer>","sort":"<string>"}'
```

### Search products

Full-text search over Plugin Boutique's product catalog. Returns paginated product listings matching the query keyword against product names and categories. Each result includes basic product info (name, brand, category, price, rating). Pagination via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g., 'reverb', 'synth', 'compressor'). |

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

## Next steps

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