# Vinylengine — 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 explore detailed specifications for over 10,000 vinyl turntables, tonearms, and cartridges from hundreds of manufacturers, complete with ratings and images. Find the perfect components for your setup by browsing comprehensive product information and manufacturer catalogs all in one place.

**Category:** Music | **Website:** [www.vinylengine.com/library.shtml](https://www.vinylengine.com/library.shtml) | **Docs:** [parse.bot/marketplace/82c6e210-3740-4d68-8f15-d08621b30e04/vinylengine-com-api](https://parse.bot/marketplace/82c6e210-3740-4d68-8f15-d08621b30e04/vinylengine-com-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/vinylengine/`
**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 turntable details

Get detailed specifications for turntables matching a specific manufacturer and optional model search. Returns matching turntable entries with full specifications. This is a filtered view of the turntable database scoped to one manufacturer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `manufacturer` | string | Yes | Manufacturer name (e.g. 'Technics', 'Thorens'). |
| `model` | string | No | Model name or prefix to search for (e.g. 'SL-1200'). Max 20 characters. |

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

### List manufacturers

List all manufacturers in a specific database (turntables, tonearms, or cartridges). Returns the complete manufacturer list along with database statistics. Useful for discovering valid manufacturer names to pass to the search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `database` | string | No | Database to query. |

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

### Search cartridges

Search the cartridge database with optional filters. Returns up to 20 matching cartridges with specifications including type, output voltage, frequency response, tracking force, mass, channel separation/balance, impedance, stylus details, cantilever, compliance, and price.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `manufacturer` | string | No | Filter by manufacturer name. Use 'any' or omit for all. |
| `model` | string | No | Filter by model name substring. |
| `sort_by` | string | No | Sort field. |
| `type` | string | No | Cartridge type filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vinylengine/search-cartridges \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"manufacturer":"<string>","model":"<string>","sort_by":"<string>","type":"<string>"}'
```

### Search tonearms

Search the tonearm database with optional filters. Returns up to 20 matching tonearms with specifications including effective length, overhang, offset angle, pivot-to-spindle distance, cartridge range, effective mass, VTA adjustment, arm mount type, headshell, and null points.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `manufacturer` | string | No | Filter by manufacturer name. Use 'any' or omit for all. |
| `model` | string | No | Filter by model name substring. |
| `order` | string | No | Sort order. |
| `sort_by` | string | No | Sort field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vinylengine/search-tonearms \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"manufacturer":"<string>","model":"<string>","order":"<string>","sort_by":"<string>"}'
```

### Search turntables

Search the turntable database with optional filters. Returns up to 20 matching turntables per page with specifications including drive type, motor, control, automation, speeds, platter, tonearm, dimensions, weight, year, and price. Paginates server-side at 20 records; records_omitted indicates overflow.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `automation` | string | No | Automation filter. |
| `changer` | string | No | Changer filter. |
| `control` | string | No | Speed control filter. |
| `drive` | string | No | Drive method filter. |
| `manufacturer` | string | No | Filter by manufacturer name. Use 'any' or omit for all. |
| `model` | string | No | Filter by model name substring (e.g. 'SL-1200'). Max 20 characters. |
| `motor` | string | No | Motor type filter. |
| `order` | string | No | Sort order. |
| `sort_by` | string | No | Sort field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/vinylengine/search-turntables \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"automation":"<string>","changer":"<string>","control":"<string>","drive":"<string>","manufacturer":"<string>","model":"<string>","motor":"<string>","order":"<string>","sort_by":"<string>"}'
```

## Next steps

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