GET /listings
Default search of listings includes only used & handmade. Add a filter to view all listings or use the /listings/all endpoint.
Servers
- https://api.reverb.com/api
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
accepts_payment_plans |
Boolean | No |
If true, only show items that can be purchased with a payment plan |
finish |
String | No |
Visual finish of the item, common for guitars |
price_min |
Number | No |
Minimum price of search results (USD) |
ships_to |
String | No |
Limit search to items that ship to this country code |
product_type |
String | No |
Product type slug from /api/categories |
shop_id |
String | No |
ID of shop to search |
currency |
String | No |
The currency to be used for the price filters |
make[] |
Array | No |
Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
query |
String | No |
Search query. |
item_city |
String | No |
City where item is located |
watchers_count_min |
Integer | No |
Minimum number of watchers (used to find popular items) |
auction_price_max |
Number | No |
Maximum current auction price |
item_country |
String | No |
DEPRECATED - Country code where item is located |
shop |
String | No |
Slug of shop to search |
handmade |
Boolean | No |
Handmade items only |
not_ids[] |
Array | No |
Listing ID negation. If you want to exclude a listing, add it here. |
conditions[] |
Array | No |
Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
year_max |
Integer | No |
Maximum year of manufacture |
exclude_auctions |
Boolean | No |
If true, exclude auctions |
model |
String | No |
Model of item (e.g. Stratocaster) |
preferred_seller |
Boolean | No |
If true, include only items by Reverb Preferred Sellers |
page |
Integer | No |
Default value: 1 |
category |
String | No |
Category slug from /api/categories |
local_pickup |
Boolean | No |
Only items that offer local pickup |
price_max |
Number | No |
Maximum price of search results (USD) |
must_not |
String | No |
Search term negation. If you want to exclude a term, add it here |
listing_type |
String | No |
Type of listing: auctions,offers |
per_page |
Integer | No |
Default value: 24 |
decade |
String | No |
Decade: e.g. 1970s, early 70s |
accepts_gift_cards |
Boolean | No |
If true, include only items that accept gift cards |
item_region |
String | No |
Country code where item is located |
year_min |
Integer | No |
Minumum year of manufacture |
item_state |
String | No |
State or region code where item is located |
offset |
Integer | No |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.