Reverb Scraper

Extract music gear listings from Reverb.com — the world's largest online marketplace for buying and selling new, used, and vintage musical instruments and gear. Collect listing details including price, condition, seller info, photos, and shipping costs at scale.

What You Can Scrape

• Search by keyword — find guitars, pedals, amps, drums, or any gear using any search term
• Enrich specific listings — provide listing URLs to extract full details for individual items
• Scrape seller/shop pages — collect all active listings from a specific shop or dealer

Output Fields

Each extracted listing contains:

Field	Type	Description
listingId	string	Unique Reverb listing identifier
title	string	Full listing title
description	string	Full item description (may contain HTML)
price	number	Listed price (numeric)
currency	string	Currency code (e.g. USD)
condition	string	Item condition label
brand	string	Instrument brand / manufacturer
year	integer	Year of manufacture (if available)
category	string	Product category (e.g. electric-guitars)
listingUrl	string	Direct URL to the listing on Reverb
photos	array	List of photo URLs for the listing
sellerName	string	Shop / seller name
sellerUrl	string	Seller's Reverb shop URL
sellerLocation	string	Seller's location (city, state, country)
sellerRating	number	Seller rating as a percentage (0–100)
offersEnabled	boolean	Whether the seller accepts offers
shippingPrice	number	US shipping cost in USD (0 = free)
recordType	string	Always "listing"
scrapedAt	string	ISO 8601 UTC timestamp of extraction

Input Options

Field	Type	Description
mode	select	searchListings, byListingUrls, or bySellerUrls
searchQuery	string	Keyword to search (required for searchListings mode)
listingUrls	array	Listing URLs to enrich (required for byListingUrls mode)
sellerUrls	array	Seller/shop URLs (required for bySellerUrls mode)
condition	array	Filter by one or more conditions
minPrice	number	Minimum price in USD
maxPrice	number	Maximum price in USD
sortBy	select	relevance, price_asc, price_desc, listing_newest
maxItems	integer	Maximum listings to extract (1–5000, default 20)

Condition Values

Value	Label
brand-new	Brand New
mint	Mint
excellent	Excellent
very-good	Very Good
good	Good
fair	Fair
poor	Poor
non-functioning	Non-Functioning

Example Inputs

Search for vintage Fender guitars under $2,000

{
  "mode": "searchListings",
  "searchQuery": "fender stratocaster vintage",
  "maxPrice": 2000,
  "condition": ["excellent", "very-good", "good"],
  "sortBy": "price_asc",
  "maxItems": 50
}

Enrich specific listing URLs

{
  "mode": "byListingUrls",
  "listingUrls": [
    "https://reverb.com/item/12345-fender-stratocaster-1968",
    "https://reverb.com/item/67890-gibson-les-paul-standard"
  ]
}

Scrape all listings from a seller

{
  "mode": "bySellerUrls",
  "sellerUrls": [
    "https://reverb.com/shop/revolution-guitarworks"
  ],
  "maxItems": 200
}

Use Cases

• Price research — compare prices across condition grades and sellers for any instrument
• Market analysis — track pricing trends for specific brands, models, or gear categories
• Dealer monitoring — watch a competitor's or partner's shop inventory
• Vintage gear hunting — find rare or collectible instruments matching specific criteria
• Deal alerts — export results and filter for bargains in any category
• Reseller sourcing — identify underpriced listings for flipping

FAQ

Does this require a Reverb account or login? No. The scraper accesses Reverb's public API — no account, cookies, or authentication is needed.

What is the maximum number of listings I can extract? The maxItems input accepts up to 5,000 listings per run. For larger data sets, run multiple times with different search queries or page offsets.

Can I filter by price and condition at the same time? Yes. minPrice, maxPrice, and condition filters can all be used together. Listings must satisfy all active filters to be included.

What does shippingPrice: 0 mean? It means the seller offers free shipping to the US. A null or missing field means the shipping cost is unknown (e.g. local-only pickup or international only).

Why might some fields be missing from a result? Fields like year, sellerRating, shippingPrice, and description are optional on Reverb — not every seller fills them in. The scraper only includes fields when Reverb returns them.

Can I scrape seller reviews or feedback? Not in the current version. The scraper focuses on active listings. Seller feedback count is not directly extracted, though sellerRating (as a percentage) is available.

Is this compliant with Reverb's terms? This scraper accesses Reverb's public, unauthenticated API endpoints — the same data served to web browsers. Always review Reverb's terms of service for your specific use case.

What is the recordType: "error" entry in the dataset? When an invalid or unresolvable URL is provided (in byListingUrls or bySellerUrls modes), an error record is written to the dataset with the original URL and a reason string, so you can identify and fix bad inputs.

What sort options are available?

• relevance — Reverb's default relevance ranking
• price_asc — cheapest first
• price_desc — most expensive first
• listing_newest — most recently listed first

Sort only applies to searchListings mode.