---
title: "Search or browse Reverb musical-instrument listings"
method: GET
path: "/reverb/search"
tags: ["Reverb"]
---

# Search or browse Reverb musical-instrument listings

`GET /reverb/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reverb/search`
- Auth: API key in header `x-api-key`

Searches or browses Reverb's (reverb.com) marketplace for new and used musical instruments and gear. query, category, product_type, make, min_price, and max_price are all optional and combine as an AND -- a free-text query can be combined with category/product_type/make/price filters in the same request, or every field can be omitted to browse the full active catalog. category accepts a leaf slug from reverb-categories' own categories[].slug field; product_type is a fixed, closed 14-value enum (listed below) that should be passed together with category from the SAME reverb-categories entry, since a category slug alone is not always globally unique (e.g. "cables" exists under both Accessories and Home Audio). An unrecognized category value is silently ignored by the upstream (returns the unfiltered catalog, not zero results or an error) -- a known upstream quirk. make accepts a manufacturer name from reverb-makes' own makes[] field and is a confirmed, real filter. A query with genuinely zero matches returns a well-formed empty result rather than an error.

## Query parameters

- `query` string
- `category` string
- `product_type` 'accessories' | 'acoustic-guitars' | 'amps' | 'band-and-orchestra' | 'bass-guitars' | 'dj-and-lighting-gear' | 'drums-and-percussion' | 'effects-and-pedals' | 'electric-guitars' | 'folk-instruments' | 'home-audio' | 'keyboards-and-synths' | 'parts' | 'pro-audio'
- `make` string
- `min_price` number
- `max_price` number
- `page` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ReverbSearchResponseDoc
  - `code` integer
  - `data` ReverbSearchResponse
    - `category` string
    - `count` integer
    - `fetched_at` string
    - `limit` integer
    - `listings` ReverbListing[]
      - `auction` boolean
      - `category_uuids` string[]
      - `condition` string
      - `condition_slug` string
      - `cover_photo_url` string
      - `created_at` string
      - `currency` string
      - `finish` string
      - `has_inventory` boolean
      - `id` integer
      - `inventory` integer
      - `make` string
      - `model` string
      - `offers_enabled` boolean
      - `photo_count` integer
      - `price` number
      - `published_at` string
      - `shop_name` string
      - `title` string
      - `url` string
      - `year` string
    - `make` string
    - `max_price` number
    - `min_price` number
    - `page` integer
    - `product_type` string
    - `query` string
    - `source_url` string
    - `total_pages` integer
    - `total_results` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)