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

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/get_brand_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_bundles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_free_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/list_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pluginboutique-com-api-f3670364/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```