--- title: "SUUMO API: Rent Search | Perceptlayer" description: "Rent Search from SUUMO as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/suumo/rent-search --- [APIs](https://perceptlayer.com/apis) / [SUUMO](https://perceptlayer.com/apis/suumo) / Rent Search # SUUMO: Rent Search Rent Search from SUUMO as JSON. 1 credit per successful call. GET `/v1/suumo/rent-search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `prefecture` | string | Required | 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 | | `city` | string | Optional | Any | | `station` | string | Optional | Any | | `line` | string | Optional | Any | | `line_group` | string | Optional | Any | | `area_code` | string | Optional | Any | | `rent_min` | integer | Optional | Any | | `rent_max` | integer | Optional | Any | | `area_min` | number | Optional | Any | | `area_max` | number | Optional | Any | | `walk_max` | integer | Optional | 1, 5, 7, 10, 15, 20 | | `age_max` | integer | Optional | 0, 1, 3, 5, 7, 10, 15, 20, 25, 30 | | `layouts` | string | Optional | Any | | `sort` | string | Optional | recommended, price\_asc, price\_desc, newest, built\_newest, area\_desc, address | | `per_page` | integer | Optional | 10, 20, 30, 50 | | `page` | integer | Optional | Any | ## Example request SUUMO GET /v1/suumo/rent-search?prefecture=tokyo&city=13104&rent\_max=100000&walk\_max=10 ``` { "success": true, "data": { "pagination": { "page": 1, "per_page": 20, "has_next_page": true, "buildings_on_page": 20 }, "filters": { "prefecture": "tokyo", "cities": [ "13104" ], "rent_max": 100000, "walk_max": 10 }, "listings": [ { "building_name": "天空ＭＵＲＡ", "building_type": "賃貸マンション", "address": "東京都新宿区西新宿６", "stations": [ { "line": "東京メトロ丸ノ内線", "station": "西新宿駅", "walk_min": 8, "raw": "東京メトロ丸ノ内線/西新宿駅 歩8分" }, { "line": "都営大江戸線", "station": "都庁前駅", "walk_min": 9, "raw": "都営大江戸線/都庁前駅 歩9分" }, { "line": "都営大江戸線", "station": "西新宿五丁目駅", "walk_min": 8, "raw": "都営大江戸線/西新宿五丁目駅 歩8分" } ], "age_text": "築11年", "age_years": 11, "floors_text": "地下1地上13階建", "floors_above": 13, "floors_below": 1, "thumbnail": "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_gw.jpg", "id": "000110744271", "building_id": "100530809314", "source_url": "https://suumo.jp/chintai/jnc_000110744271/", "floor": "4階", "rent_text": "8.9万円", "rent_yen": 89000, "admin_fee_text": "4000円", "admin_fee_yen": 4000, "deposit_text": "8.9万円", "deposit_yen": 89000, "key_money_text": "8.9万円", "key_money_yen": 89000, "layout": "1K", "area_text": "12.92m2", "area_m2": 12.92, "images": [ "https://img01.suumo.com/front/gazo/fr/bukken/314/100530809314/100530809314_go.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/314/100530809314/100530809314_co.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/314/100530809314/100530809314_11o.jpg" ] }, { "building_name": "天空ＭＵＲＡ", "building_type": "賃貸マンション", "address": "東京都新宿区西新宿６", "stations": [ { "line": "東京メトロ丸ノ内線", "station": "西新宿駅", "walk_min": 8, "raw": "東京メトロ丸ノ内線/西新宿駅 歩8分" }, { "line": "都営大江戸線", "station": "都庁前駅", "walk_min": 9, "raw": "都営大江戸線/都庁前駅 歩9分" }, { "line": "都営大江戸線", "station": "西新宿五丁目駅", "walk_min": 8, "raw": "都営大江戸線/西新宿五丁目駅 歩8分" } ], "age_text": "築11年", "age_years": 11, "floors_text": "地下1地上13階建", "floors_above": 13, "floors_below": 1, "thumbnail": "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_gw.jpg", "id": "000110744273", "building_id": "100528753269", "source_url": "https://suumo.jp/chintai/jnc_000110744273/", "floor": "8階", "rent_text": "9.3万円", "rent_yen": 93000, "admin_fee_text": "4000円", "admin_fee_yen": 4000, "deposit_text": "9.3万円", "deposit_yen": 93000, "key_money_text": "9.3万円", "key_money_yen": 93000, "layout": "1K", "area_text": "12.81m2", "area_m2": 12.81, "images": [ "https://img01.suumo.com/front/gazo/fr/bukken/269/100528753269/100528753269_go.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/269/100528753269/100528753269_co.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/269/100528753269/100528753269_1o.jpg" ] }, { "building_name": "天空ＭＵＲＡ", "building_type": "賃貸マンション", "address": "東京都新宿区西新宿６", "stations": [ { "line": "東京メトロ丸ノ内線", "station": "西新宿駅", "walk_min": 8, "raw": "東京メトロ丸ノ内線/西新宿駅 歩8分" }, { "line": "都営大江戸線", "station": "都庁前駅", "walk_min": 9, "raw": "都営大江戸線/都庁前駅 歩9分" }, { "line": "都営大江戸線", "station": "西新宿五丁目駅", "walk_min": 8, "raw": "都営大江戸線/西新宿五丁目駅 歩8分" } ], "age_text": "築11年", "age_years": 11, "floors_text": "地下1地上13階建", "floors_above": 13, "floors_below": 1, "thumbnail": "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_gw.jpg", "id": "000110744272", "building_id": "100479868127", "source_url": "https://suumo.jp/chintai/jnc_000110744272/", "floor": "5階", "rent_text": "9.5万円", "rent_yen": 95000, "admin_fee_text": "4000円", "admin_fee_yen": 4000, "deposit_text": "9.5万円", "deposit_yen": 95000, "key_money_text": "9.5万円", "key_money_yen": 95000, "layout": "1K", "area_text": "13.26m2", "area_m2": 13.26, "images": [ "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_ro.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_co.jpg", "https://img01.suumo.com/front/gazo/fr/bukken/127/100479868127/100479868127_go.jpg" ] } ] }, "meta": { "endpoint_family": "rent_search", "request_id": "req_10f2461c872b4ff7b034294a0968830b", "credits_charged": 1, "credits_remaining": 1808 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/suumo?try=rent-search#playground) with your own parameters. 1 credit per successful call; failed calls are free.