# KVR Audio — 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 thousands of VST plugins, virtual instruments, and audio effects from the KVR Audio database, finding exactly what you need by plugin type, developer, or features. Browse detailed product information including developer names, specifications, and software details to compare and evaluate music production tools.

**Category:** Music | **Website:** [www.kvraudio.com/](https://www.kvraudio.com/) | **Docs:** [parse.bot/marketplace/336b3c79-415e-4b81-a677-c29d292cc848/kvraudio-com-api](https://parse.bot/marketplace/336b3c79-415e-4b81-a677-c29d292cc848/kvraudio-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-kvraudio-com-api-336b3c79/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Fetch detailed information for a single plugin product by its URL slug. Returns the full description, developer info, category, price, supported operating systems, and plugin formats. The slug is obtained from the url_slug field in search_plugins or list_plugins results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product URL slug from url_slug field in search_plugins or list_plugins results (e.g. 'serum-by-xfer-records', 'annulus-by-phase-fiasco') |

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

### list_plugins

List plugins from a specific category or department page on KVR Audio. Returns up to 20 products from the first page of the given category slug. Categories correspond to URL path segments on the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug from the KVR URL path (e.g. 'the-newest-plugins', 'most-popular-audio-software', 'reverb', 'delay', 'eq') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kvraudio-com-api-336b3c79/list_plugins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### search_plugins

Full-text search over the KVR Audio product database. Matches plugin names, developers, and descriptions. Returns up to 20 products per page with developer, category, price, formats, and OS compatibility. Only page 1 is returned per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'reverb', 'synthesizer', 'compressor') |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kvraudio-com-api-336b3c79/search_plugins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","sort_by":"<string>"}'
```
