# KVR Audio — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/kvr-audio/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/kvr-audio/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kvr-audio/list-plugins \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kvr-audio/search-plugins \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","sort_by":"<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.