Reverb

Reverb listed price, price before a drop, condition, make, model, year, finish, category, shop and shop rating, offers flag, quantity and shipping price, by listing id, about 1 million listings per credit. Sold listings too. Search for available or sold listings. No listing rating, and no sold price or date.

Embed
Preview of the card
<a href="https://scrapelyserp.com/docs/reverb-products"><img src="https://scrapelyserp.com/docs/_api/public/orgs/affc5b0f-d3c2-423a-8143-9d10db5736ae/spaces/981e6275-da3f-446c-82de-889f59c83b6f/pages/76825011-344d-46a1-9dd3-45348012c5da/social-card.svg?v=3e7ae33eec8b" alt="Reverb" width="600" height="315"></a>

Reverb listed price, price before a drop, condition, make, model, year, finish, category, shop and shop rating, offers flag, quantity and shipping price, by listing id, about 1 million listings per credit. Sold listings too. Search for available or sold listings. No listing rating, and no sold price or date.

At a glance

Property

Value

platform

reverb

Item id

The number after /item/ in a Reverb listing link, https://reverb.com/item/103777264-boss-ds-1-distortion-silver-label (103777264). A pasted listing link is reduced to its id. Search returns the same id.

Marketplaces

Live: us.

Tier

standard (the default), about 1 million listings per credit (an estimate until production traffic measures it)

Ids per call

50. Each listing is its own lookup, so a call with many ids takes proportionally longer.

Typical call

10–25 s for 50 listings

Search

GET /v1/structured/reverb/search by keyword or category, for available or sold listings, about 2.5 million results per credit.

What a sold listing's price means

price is the listed price: the last price the listing carried, also on a sold listing. Reverb gives no sold price and no sold date, so a sold row's price is not necessarily what the buyer paid (an accepted offer can sell below the listed price). A sold listing's publishedAt is when it went up, not when it sold.

Price before a drop

reverb.originalPrice (list_price in search) is the price before the seller's price drop, and null when the price never dropped (it is not 0). It is the seller's own earlier price: not a retail price and not a claim about a discount elsewhere.

Search reaches 2,500 listings per query

However large total_results is, a query returns its first 2,500 listings (page 1 to 50, 50 each). To go deeper, split the query with condition, min_price / max_price and category. Asking by id has no such limit.

Example

curl -X POST "https://api.scrapelyserp.com/v1/products" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "reverb",
    "ids": [
      "103777264",
      "https://reverb.com/item/14746554-boss-ds-1-keeley-ultra-signed-mint"
    ]
  }'

Full reference → POST /v1/products

Reverb fields

Besides the common fields, each result carries a reverb object.

Field

Description

price

The listed price, in dollars. null if Reverb gives none. On a sold listing it is the last listed price, not a sale price.

availability

inStock is true for an available listing and false for a sold one, from the listing's own state. Any other state (an ended listing) states nothing, and availability is left out.

reverb.status

available or sold; any other state as Reverb writes it.

reverb.originalPrice

The price before the seller's price drop; null when the price never dropped.

reverb.condition

Reverb's condition name: Brand New, Mint, Excellent, Very Good, Good, Fair, Poor and the like; null when the listing has none.

reverb.make, model, year, finish, category

As the seller filled them in. year is free text (1994 - Present, 2010s). category is the first category path (Effects and Pedals / Distortion). Empty values are null.

reverb.seller

The seller's shop name.

reverb.sellerRating, sellerFeedbackCount

The shop's positive-feedback share in percent (98.7) and how many feedbacks it has. These describe the shop, not the listing. Only a product lookup carries them; search rows leave them null. null also for a shop with no feedback.

reverb.offersEnabled, quantity

Whether the seller takes offers, and the quantity the seller lists.

reverb.shippingPrice, shippingEstimated

The shipping charge to the contiguous US (0 for free shipping; null when the listing gives none), and whether Reverb works it out per buyer, so the figure is for a default address.

reverb.createdAt, publishedAt

When the listing was created and published (ISO 8601, with the offset Reverb writes).

url, images

The listing link and its first picture.

Not given

A rating or review count for the listing (listings have none), a sold price or sold date, the listing's other pictures, description and shipping to other regions.

Prices in dollars

Reverb shows buyers the price in dollars whatever currency the seller listed in. price.currency is what Reverb reports, normally USD.

Statuses on Reverb

  • partial: Reverb answered without a title. Ask again later.

  • not_found: Reverb has no such listing id, available or sold. A deleted listing is not found.

  • unavailable: no usable answer after retries. Not charged; ask again.

Updated