Skip to main content
POST
/reverb/items/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: 1 <= x <= 2500
timeout
integer
default:300
Required range: 20 <= x <= 1500
currency
enum<string>
default:USD
Available options:
USD,
CAD,
EUR,
GBP,
AUD,
JPY,
NZD
shipping_region
enum<string>
default:US_CON
Available options:
XX,
US_CON,
CA,
GB,
AU,
FR,
DE,
JP,
ID,
US_AK,
US_HI,
US_PR,
US_OTHER
locale
enum<string>
default:en
Available options:
en,
fr,
ja,
es,
de,
it
query
string | null
make
string | null
product_type
string | null
category
string | null
condition
enum<string>[] | null
Available options:
new,
used,
b-stock,
brand-new,
mint,
excellent,
very-good,
good,
fair,
poor,
non-functioning
price_min
number | null
Required range: x >= 0
price_max
number | null
Required range: x >= 0
year_min
integer | null
year_max
integer | null
decade
enum<string> | null
Available options:
2020s,
2010s,
2000s,
1990s,
1980s,
1970s,
1960s,
1950s,
pre-1950s
sort
enum<string> | null
Available options:
best_match,
price_asc,
price_desc,
most_recent,
recently_listed
free_shipping
boolean | null
free_expedited_shipping
boolean | null
local_pickup
boolean | null
handmade
boolean | null
on_sale
boolean | null
zero_percent_financing
boolean | null
preferred_seller
boolean | null
ships_to
enum<string> | null
Available options:
XX,
US_CON,
CA,
GB,
AU,
FR,
DE,
JP,
ID,
US_AK,
US_HI,
US_PR,
US_OTHER

Response

Successful Response

id
string
required
listing_title
string
required
@type
string
default:ReverbSearchItem
url
string | null
make
string | null
model
string | null
finish
string | null
year
string | null
price
number | null
currency
string | null
price_display
string | null
buyer_price
number | null
listing_currency
string | null
condition
object | null
categories
object[]
state
string | null
is_auction
boolean
default:false
accepts_offers
boolean
default:false
inventory
integer | null
shop_id
integer | null
shop_name
string | null
shop_alias
string | null
is_shop_preferred_seller
boolean
default:false
shipping
object | null
created_at
integer | null
published_at
integer | null