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

## Access

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

## 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/parse-vinylengine-com-api-82c6e210/get_turntable_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-vinylengine-com-api-82c6e210/list_manufacturers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-vinylengine-com-api-82c6e210/search_cartridges \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-vinylengine-com-api-82c6e210/search_tonearms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-vinylengine-com-api-82c6e210/search_turntables \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```