Skip to main content
POST
/yahoo/auctions/items/closed/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required
Minimum string length: 1
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
category
integer | null
Required range: x >= 0
price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0
condition
enum<string> | null
Available options:
new,
used,
like_new,
no_visible_damage,
slight_damage,
damaged,
poor
region
enum<string> | null
Available options:
hokkaido,
aomori,
iwate,
miyagi,
akita,
yamagata,
fukushima,
ibaraki,
tochigi,
gunma,
saitama,
chiba,
tokyo,
kanagawa,
yamanashi,
nagano,
niigata,
toyama,
ishikawa,
fukui,
gifu,
shizuoka,
aichi,
mie,
shiga,
kyoto,
osaka,
hyogo,
nara,
wakayama,
tottori,
shimane,
okayama,
hiroshima,
yamaguchi,
tokushima,
kagawa,
ehime,
kochi,
fukuoka,
saga,
nagasaki,
kumamoto,
oita,
miyazaki,
kagoshima,
okinawa,
overseas
brand_id
integer | null
Required range: x >= 0
free_shipping
boolean
default:false
has_image
boolean
default:false
keyword_exclude
string | null
seller_type
enum<string> | null
Available options:
store,
individual
sort
enum<string>
default:ended_recent
Available options:
ended_recent,
ended_oldest,
price_asc,
price_desc,
bids_desc,
bids_asc,
popular,
featured

Response

Successful Response

id
string
required
url
string
required
name
string
required
@type
string
default:YahooAuctionsItemCard
image
string | null
price
integer | null
buy_now_price
integer | null
start_price
integer | null
is_taxed
boolean | null
bid_count
integer | null
watch_count
integer | null
start_at
integer | null
end_at
integer | null
condition
string | null
category
object | null
category_path
object[]
brand_id
integer | null
region
string | null
region_code
integer | null
marketplace
string | null
is_fixed_price
boolean | null
is_free_shipping
boolean | null
is_new_arrival
boolean | null
is_appraisal
boolean | null
seller
object | null