Reverb

Search or browse Reverb musical-instrument listings

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.

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

Query parameters

querystring

Free-text search query

categorystring

Category facet filter, from reverb-categories' own categories[].slug field -- pass together with product_type from the same entry

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'

Product-type filter

makestring

Manufacturer name filter, from reverb-makes' own makes[] field

min_pricenumber

Minimum price (inclusive), in USD

max_pricenumber

Maximum price (inclusive), in USD

pageinteger

One-based page number, defaults to 1

limitinteger

Results per page, defaults to 24, maximum 50 (the upstream's own silent cap)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.