Skip to main content
POST
/joshin/products/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
genre
enum<string> | null
Available options:
kaden,
season,
house,
kitchen,
health,
interior,
av,
sound,
audio,
pc,
peripheral,
supply,
mobile,
camera,
car,
diy,
outdoor,
apparel,
watch,
game,
toy,
hobby,
train,
cg,
liquor,
drug
maker
string | null
Minimum string length: 1
model_code
string | null
Minimum string length: 1
price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0
release_date_from
string | null
Pattern: ^\d{4}-\d{2}-\d{2}$
release_date_to
string | null
Pattern: ^\d{4}-\d{2}-\d{2}$
color
enum<string> | null
Available options:
black,
white,
grey,
red,
pink,
purple,
blue,
green,
yellow_orange,
brown,
beige,
silver,
gold,
clear,
other
in_stock
boolean
default:false
on_sale
boolean
default:false
is_new
boolean
default:false
is_reserve
boolean
default:false
is_limited
boolean
default:false
has_coupon
boolean
default:false
has_guarantee
boolean
default:false
ships_24h
boolean
default:false
medicine_audience
enum<string> | null
Available options:
both,
adult,
child
medicine_class
enum<string> | null
Available options:
designated_class_2,
class_2,
class_3
dosage_form
enum<string> | null
Available options:
powder,
granules,
fine_granules,
tablet,
pill,
capsule,
troche,
lozenge,
jelly_drop,
oral_liquid,
topical_liquid,
ointment,
plaster,
poultice,
adhesive_plaster,
suppository,
infusion,
decoction,
chewing_gum,
other_oral,
other_topical,
other
is_quasi_drug
boolean
default:false
sort
enum<string>
default:relevance
Available options:
relevance,
release_date_desc,
release_date_asc,
price_asc,
price_desc,
model_code,
most_reviewed,
best_rated

Response

Successful Response

id
string
required
url
string
required
genre
string
required
category_id
string
required
@type
string
default:JoshinProductCard
name
string | null
maker
string | null
model_code
string | null
image
string | null
price
number | null
currency
string
default:JPY
point
integer | null
point_rate
number | null
stock_message
string | null
is_in_stock
boolean | null
delivery_message
string | null
release_date
string | null
review_group
string | null
is_sponsored
boolean
default:false