# Reverb — 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 music gear listings on Reverb.com by keyword, price, condition, category, brand, and year to find the perfect instrument or equipment. Filter results to compare vintage guitars, synthesizers, drums, and more across different price ranges and conditions.

**Category:** Marketplaces | **Website:** [reverb.com/](https://reverb.com/) | **Docs:** [parse.bot/marketplace/58df408f-1da4-428a-bdfe-7b301ea01ca2/reverb-com-api](https://parse.bot/marketplace/58df408f-1da4-428a-bdfe-7b301ea01ca2/reverb-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-reverb-com-api-58df408f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_listings

Search for music gear listings on Reverb. Supports keyword search, pagination, and filtering by price range, condition, category, brand, year, and sort order. Returns paginated results capped at 50 total pages. Each listing includes pricing, condition, images, shipping details, and seller info. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Product type slug to filter by category (e.g. 'electric-guitars', 'acoustic-guitars', 'bass-guitars', 'keyboards-and-synths') |
| `condition` | string | No | Filter by condition slug |
| `currency` | string | No | Display currency code (e.g. 'USD', 'EUR', 'GBP') |
| `make` | string | No | Filter by brand/manufacturer (e.g. 'Fender', 'Gibson', 'Roland') |
| `page` | integer | No | Page number for pagination |
| `per_page` | integer | No | Results per page (1-50) |
| `price_max` | string | No | Maximum price filter (e.g. '1500') |
| `price_min` | string | No | Minimum price filter (e.g. '500') |
| `query` | string | No | Search keywords (e.g. 'fender stratocaster', 'gibson les paul') |
| `ships_to` | string | No | Shipping region code (e.g. 'US_CON', 'EUR_EU', 'GB') |
| `sort` | string | No | Sort order for results |
| `year_max` | string | No | Maximum year filter (e.g. '1970') |
| `year_min` | string | No | Minimum year filter (e.g. '1960') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-reverb-com-api-58df408f/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","condition":"<string>","currency":"<string>","make":"<string>","page":"<integer>","per_page":"<integer>","price_max":"<string>","price_min":"<string>","query":"<string>","ships_to":"<string>","sort":"<string>","year_max":"<string>","year_min":"<string>"}'
```