Skip to main content
POST
/mercari/items/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: 1 <= x <= 600
timeout
integer
default:300
Required range: 20 <= x <= 1500
category_id
integer | null
sort
enum<string> | null
Available options:
score,
created_time,
price,
num_likes
order
enum<string> | null
Available options:
desc,
asc
status
enum<string>[] | null
Available options:
on_sale,
sold_out,
trading
price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0

Response

Successful Response

id
string
required
url
string
required
name
string
required
@type
string
default:MercariSearchItem
price
integer
default:0
currency
string
default:JPY
status
string | null
photo
string | null
thumbnail
string | null
condition_id
integer | null
category_id
integer | null
brand
object | null
seller_id
integer | null
shop_name
string | null
shipping_payer_id
integer | null
shipping_method_id
integer | null
item_type
string | null
is_no_price
boolean
default:false
is_liked
boolean
default:false
auction
object | null
created_at
integer | null
updated_at
integer | null