Reverb Marketplace Listings Scraper
Reverb Marketplace Listings Scraper
Fetch live listings from Reverb's music gear marketplace using the official HAL+JSON API — not fragile HTML scraping. Search by keyword, condition, or category and get structured data on price, seller, photos, shipping, and more.
What it does
This actor queries api.reverb.com/api/listings — Reverb's public JSON API — and returns structured records for every listing matching your search. Unlike competitors that scrape Reverb's HTML store (which returns 403 to most automated clients), this actor targets the stable JSON endpoint directly. That means no proxy required, no browser overhead, and far lower run costs.
Each record includes flat, analysis-ready fields: asking price, condition, seller shop, primary photo URL, category, shipping details, and a direct link back to the listing on reverb.com.
Use cases
- Resellers and deal hunters — monitor specific instruments (e.g. "jazzmaster", "martin d28") for new listings below market value
- Market analysts — track pricing trends across condition grades and categories over time
- Inventory research — benchmark your own listings against comparable active inventory
Inputs
| Field | Type | Description |
|---|---|---|
maxItems |
integer (required) | Maximum number of listings to return. The Reverb API caps each query at 2,500 results (50 pages x 50 per page). |
query |
string (optional) | Keyword search — e.g. jazzmaster, fender stratocaster, martin d28. Leave blank to browse all live listings. |
condition |
string (optional) | Condition slug filter. Common values: used, good, very-good, excellent, mint, brand-new, b-stock, non-functioning. |
categoryUuid |
string (optional) | Reverb category UUID — e.g. e57deb7a-382b-4e18-a008-67d4fbcb2879 for Electric Guitars / Solid Body. Leave blank for all categories. |
Output fields
| Field | Description |
|---|---|
id |
Reverb listing ID (integer) |
title |
Listing title |
make |
Instrument maker / brand |
model |
Instrument model |
year |
Year or year range |
finish |
Finish color or description |
condition |
Condition slug (e.g. excellent, mint) |
condition_display |
Human-readable condition label |
price_amount |
Asking price as a decimal string |
price_currency |
Currency code (e.g. USD) |
buyer_price_amount |
Buyer-facing price including any fees |
buyer_price_currency |
Buyer price currency code |
shipping_free_expedited |
Whether free expedited shipping is available |
shipping_local |
Whether local pickup is available |
categories |
Comma-separated category full names |
state |
Listing state slug (live, sold, ended) |
inventory |
Quantity available |
has_inventory |
Whether quantity tracking is active |
offers_enabled |
Whether the seller accepts offers |
auction |
Whether the listing is an auction |
shop_name |
Seller shop display name |
shop_slug |
Seller shop URL slug |
photo_url |
URL of the primary listing photo (full size) |
description |
Listing description (may contain HTML) |
published_at |
ISO timestamp when the listing was published |
reverb_url |
Full URL to the listing on reverb.com |
scraped_at |
ISO timestamp when the record was collected |
Notes
- The Reverb API returns at most 50 results per page and caps pagination at 50 pages — 2,500 listings per query. For broader coverage, run multiple queries with different keywords or category filters.
- No API key or authentication is required. The actor sends polite pacing delays between pages.
- The
descriptionfield contains HTML — strip tags if you need plain text.