Skip to main content
POST
/jmty/listings/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
vertical
enum<string>
required
Available options:
sale,
car,
pet,
com,
coop,
rec,
job,
les,
eve,
est,
ser
count
integer
required
Required range: 1 <= x <= 50000
timeout
integer
default:300
Required range: 20 <= x <= 1500
prefecture
enum<string>
default:all
Available options:
all,
hokkaido,
aomori,
iwate,
miyagi,
akita,
yamagata,
fukushima,
ibaraki,
tochigi,
gunma,
saitama,
chiba,
tokyo,
kanagawa,
niigata,
toyama,
ishikawa,
fukui,
yamanashi,
nagano,
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
category
enum<string> | null
Available options:
adl,
alf,
amu,
aud,
auto,
ban,
bea,
bic,
bik,
bmw,
boo,
buy,
care,
cat,
cel,
chat,
chi,
clo,
con,
cons,
coo,
cos,
craf,
cre,
dai,
dan,
desk,
dis,
dog,
eat,
edu,
ele,
eng,
ent,
etc,
fes,
flo,
food,
free,
fri,
fur,
gar,
gard,
gou,
hcl,
hea,
help,
hom,
hon,
hou,
inc,
it,
jpn,
kid,
lan,
land,
les,
lex,
lif,
lig,
liv,
mas,
maz,
medi,
mer,
min,
mit,
mob,
mot,
mov,
mus,
nis,
npo,
nurs,
off,
oth,
par,
pc,
pcp,
pes,
pet,
peu,
pic,
plan,
pro,
qua,
recy,
rent,
res,
sab,
sale,
scr,
sdri,
sec,
ser,
sha,
sho,
shop,
shou,
sof,
spo,
stu,
sub,
suz,
tic,
tou,
town,
toy,
trad,
tran,
tro,
vol,
volv,
wed,
whlp,
wles,
work,
wrnt
genre_id
integer | null
Required range: x > 0
area_id
integer | null
Required range: x > 0
station_id
integer | null
Required range: x > 0
line_id
integer | null
Required range: x > 0
keyword
string
default:""
min_price
integer | null
Required range: x >= 0
max_price
integer | null
Required range: x >= 0
poster_type
enum<string> | null
Available options:
individual,
corporate
online_payment
boolean | null
pay_system
enum<string> | null
Available options:
hourly,
daily,
monthly
min_model_year
integer | null
Required range: 1900 <= x <= 2100
max_model_year
integer | null
Required range: 1900 <= x <= 2100
min_mileage
integer | null
Required range: x >= 0
max_mileage
integer | null
Required range: x >= 0
event_date
string
default:""
Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Successful Response

key
string
required
listing_title
string
required
@type
string
default:JmtyListingCard
text
string | null
price
number | null
price_label
string | null
currency
string
default:JPY
vertical
string | null
category
string | null
genre
object | null
prefecture
object | null
city
object | null
station
object | null
keywords
string[]
labels
string[]
created_date
string | null
updated_date
string | null
favorite_count
integer | null
image
string | null
url
string | null