The Reverb Search API returns music gear listings from Reverb. Pass a keyword, a query string, or a full marketplace URL and receive structured JSON with prices, thumbnails, and pagination.
Reverb is a React/Apollo SPA. Piloterr uses browser rendering and waits for Apollo listing data in <meta content="Listing:id:…"> tags before parsing.
Use each result url or listing_id with Reverb Product for full listing details (description, gallery, shop, year).
GET https://api.piloterr.com/v2/reverb/search?query=guitar
GET https://api.piloterr.com/v2/reverb/search?query=query=guitar&product_type=electric-guitars
GET https://api.piloterr.com/v2/reverb/search?query=https://reverb.com/marketplace?query=guitar&product_type=electric-guitars
GET https://api.piloterr.com/v2/reverb/search?query=guitar&page=2
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword, query=…&product_type=…, or marketplace URL |
page |
integer |
no |
1-based page override (default: from URL or 1) |
return_page_source |
boolean |
no |
Raw HTML as {"result": "..."} (default: false) |
| Format |
Example |
| Keyword |
guitar |
| Query string |
query=guitar&product_type=electric-guitars |
| Full URL |
https://reverb.com/marketplace?query=guitar&product_type=electric-guitars |
| Shop search URL |
https://reverb.com/shop/… |
| Field |
Type |
Description |
listing_id |
string |
Reverb listing id |
title |
string |
Listing title |
url |
string |
Listing URL (bk tracker stripped) |
price |
number |
Buyer price |
image_url |
string |
Card thumbnail |
make |
string | null |
Brand (when Apollo exposes it) |
model |
string | null |
Model |
year |
integer | null |
Year |
finish |
string | null |
Finish / color |
price_display |
string | null |
Formatted price |
currency |
string | null |
ISO currency |
condition |
string | null |
Item condition |
state |
string | null |
Listing state (live, sold, …) |
category |
string | null |
Primary category |
shop |
object | null |
Seller shop summary |
Search often returns the minimal set (listing_id, title, url, price, image_url). Use Reverb Product for full records.
| Field |
Type |
Description |
page |
integer |
Current page |
per_page |
integer |
Results on this page (~24–56) |
total_results |
integer | null |
Often null |
total_pages |
integer | null |
Often null |
next |
string | null |
Next page URL |
- Reverb Search: discover listings (this endpoint)
- Reverb Product: full listing JSON
| Code |
Meaning |
400 |
Missing or invalid query |
404 |
Skeleton page or no parseable listings |
500 |
Rendering or parsing error |
- Listing URLs may include locale prefixes (
/fr/item/…).
- The
bk tracking query param is stripped from all returned URLs.
- Costs 2 credits per call (browser rendering).
- Gear discovery: harvest listing ids across categories and filters
- Price monitoring: track buyer prices on used instruments
- Marketplace intel: compare listings before fetching full PDP data
