GET /listings

reverb.com

Summary: Default search of listings includes only used & handmade. Add a filter to view all listings or use the /listings/all endpoint.
Operation ID: —
Auth: unknown
Description

Default search of listings includes only used & handmade. Add a filter to view all listings or use the /listings/all endpoint.

Parameters (34)

accepts_gift_cards (boolean, query, optional)

If true, include only items that accept gift cards

accepts_payment_plans (boolean, query, optional)

If true, only show items that can be purchased with a payment plan

auction_price_max (number, query, optional)

Maximum current auction price

category (string, query, optional)

Category slug from /api/categories

conditions (array, query, optional)

Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint

currency (string, query, optional)

The currency to be used for the price filters

decade (string, query, optional)

Decade: e.g. 1970s, early 70s

exclude_auctions (boolean, query, optional)

If true, exclude auctions

finish (string, query, optional)

Visual finish of the item, common for guitars

handmade (boolean, query, optional)

Handmade items only

item_city (string, query, optional)

City where item is located

item_country (string, query, optional)

DEPRECATED - Country code where item is located

item_region (string, query, optional)

Country code where item is located

item_state (string, query, optional)

State or region code where item is located

listing_type (string, query, optional)

Type of listing: auctions,offers

local_pickup (boolean, query, optional)

Only items that offer local pickup

make (array, query, optional)

Make(s)/brand of item (e.g. Fender). Can take a single value or an array.

model (string, query, optional)

Model of item (e.g. Stratocaster)

must_not (string, query, optional)

Search term negation. If you want to exclude a term, add it here

not_ids (array, query, optional)

Listing ID negation. If you want to exclude a listing, add it here.

offset (integer, query, optional)
page (integer, query, optional, default: 1)
per_page (integer, query, optional, default: 24)
preferred_seller (boolean, query, optional)

If true, include only items by Reverb Preferred Sellers

price_max (number, query, optional)

Maximum price of search results (USD)

price_min (number, query, optional)

Minimum price of search results (USD)

product_type (string, query, optional)

Product type slug from /api/categories

query (string, query, optional)

Search query.

ships_to (string, query, optional)

Limit search to items that ship to this country code

shop (string, query, optional)

Slug of shop to search

shop_id (string, query, optional)

ID of shop to search

watchers_count_min (integer, query, optional)

Minimum number of watchers (used to find popular items)

year_max (integer, query, optional)

Maximum year of manufacture

year_min (integer, query, optional)

Minumum year of manufacture

No probe data for this endpoint yet.