SUUMO API

API ID 15074

Japanese real estate: prefectures and cities, rental search with rent, area, walking time and layout filters, rental details, condominium, house and land sale search and details.

API Documentation

Endpoints

Request
Lists the prefectures of Japan with the code accepted by the "prefecture" parameter, their English and Japanese name and their region.
Endpoint ID: 39970
GET https://zylalabs.com/api/15074/suumo+api/39970/prefectures
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "code": "01",
        "name": "Hokkaido",
        "name_ja": "北海道",
        "region": "Hokkaido"
    },
    {
        "code": "02",
        "name": "Aomori",
        "name_ja": "青森県",
        "region": "Tohoku"
    },
    {
        "code": "03",
        "name": "Iwate",
        "name_ja": "岩手県",
        "region": "Tohoku"
    },
    {
        "code": "04",
        "name": "Miyagi",
        "name_ja": "宮城県",
        "region": "Tohoku"
    },
    {
        "code": "05",
        "name": "Akita",
        "name_ja": "秋田県",
        "region": "Tohoku"
    },
    {
        "code": "06",
        "name": "Yamagata",
        "name_ja": "山形県",
        "region": "Tohoku"
    },
    {
        "code": "07",
        "name": "Fukushima",
        "name_ja": "福島県",
        "region": "Tohoku"
    },
    {
        "code": "08",
        "name": "Ibaraki",
        "name_ja": "茨城県",
        "region": "Kanto"
    },
    {
        "code": "09",
        "name": "Tochigi",
        "name_ja": "栃木県",
        "region": "Kanto"
    },
    {
        "code": "10",
        "name": "Gunma",
        "name_ja": "群馬県",
        "region": "Kanto"
    },
    {
        "code": "11",
        "name": "Saitama",
        "name_ja": "埼玉県",
        "region": "Kanto"
    },
    {
        "code": "12",
        "name": "Chiba",
        "name_ja": "千葉県",
        "region": "Kanto"
    },
    {
        "code": "13",
        "name": "Tokyo",
        "name_ja": "東京都",
        "region": "Kanto"
    },
    {
        "code": "14",
        "name": "Kanagawa",
        "name_ja": "神奈川県",
        "region": "Kanto"
    },
    {
        "code": "15",
        "name": "Niigata",
        "name_ja": "新潟県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "16",
        "name": "Toyama",
        "name_ja": "富山県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "17",
        "name": "Ishikawa",
        "name_ja": "石川県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "18",
        "name": "Fukui",
        "name_ja": "福井県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "19",
        "name": "Yamanashi",
        "name_ja": "山梨県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "20",
        "name": "Nagano",
        "name_ja": "長野県",
        "region": "Koshinetsu and Hokuriku"
    },
    {
        "code": "21",
        "name": "Gifu",
        "name_ja": "岐阜県",
        "region": "Tokai"
    },
    {
        "code": "22",
        "name": "Shizuoka",
        "name_ja": "静岡県",
        "region": "Tokai"
    },
    {
        "code": "23",
        "name": "Aichi",
        "name_ja": "愛知県",
        "region": "Tokai"
    },
    {
        "code": "24",
        "name": "Mie",
        "name_ja": "三重県",
        "region": "Tokai"
    },
    {
        "code": "25",
        "name": "Shiga",
        "name_ja": "滋賀県",
        "region": "Kansai"
    },
    {
        "code": "26",
        "name": "Kyoto",
        "name_ja": "京都府",
        "region": "Kansai"
    },
    {
        "code": "27",
        "name": "Osaka",
        "name_ja": "大阪府",
        "region": "Kansai"
    },
    {
        "code": "28",
        "name": "Hyogo",
        "name_ja": "兵庫県",
        "region": "Kansai"
    },
    {
        "code": "29",
        "name": "Nara",
        "name_ja": "奈良県",
        "region": "Kansai"
    },
    {
        "code": "30",
        "name": "Wakayama",
        "name_ja": "和歌山県",
        "region": "Kansai"
    },
    {
        "code": "31",
        "name": "Tottori",
        "name_ja": "鳥取県",
        "region": "Chugoku"
    },
    {
        "code": "32",
        "name": "Shimane",
        "name_ja": "島根県",
        "region": "Chugoku"
    },
    {
        "code": "33",
        "name": "Okayama",
        "name_ja": "岡山県",
        "region": "Chugoku"
    },
    {
        "code": "34",
        "name": "Hiroshima",
        "name_ja": "広島県",
        "region": "Chugoku"
    },
    {
        "code": "35",
        "name": "Yamaguchi",
        "name_ja": "山口県",
        "region": "Chugoku"
    },
    {
        "code": "36",
        "name": "Tokushima",
        "name_ja": "徳島県",
        "region": "Shikoku"
    },
    {
        "code": "37",
        "name": "Kagawa",
        "name_ja": "香川県",
        "region": "Shikoku"
    },
    {
        "code": "38",
        "name": "Ehime",
        "name_ja": "愛媛県",
        "region": "Shikoku"
    },
    {
        "code": "39",
        "name": "Kochi",
        "name_ja": "高知県",
        "region": "Shikoku"
    },
    {
        "code": "40",
        "name": "Fukuoka",
        "name_ja": "福岡県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "41",
        "name": "Saga",
        "name_ja": "佐賀県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "42",
        "name": "Nagasaki",
        "name_ja": "長崎県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "43",
        "name": "Kumamoto",
        "name_ja": "熊本県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "44",
        "name": "Oita",
        "name_ja": "大分県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "45",
        "name": "Miyazaki",
        "name_ja": "宮崎県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "46",
        "name": "Kagoshima",
        "name_ja": "鹿児島県",
        "region": "Kyushu and Okinawa"
    },
    {
        "code": "47",
        "name": "Okinawa",
        "name_ja": "沖縄県",
        "region": "Kyushu and Okinawa"
    }
]
Prefectures — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39970/prefectures' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the cities, wards and districts of a prefecture with the code accepted by the "cities" parameter, their Japanese name, romanized name, the part of the prefecture they belong to and their coordinates.
Endpoint ID: 39971
GET https://zylalabs.com/api/15074/suumo+api/39971/cities+of+a+prefecture
INPUT PARAMETERS

Cities of a prefecture — Endpoint Features

Object Description
prefecture Required Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

prefecture
API EXAMPLE RESPONSE
JSON
[
    {
        "code": "13101",
        "name": "千代田区",
        "slug": "chiyoda",
        "area": "都心部",
        "latitude": 35.690806,
        "longitude": 139.756819
    },
    {
        "code": "13102",
        "name": "中央区",
        "slug": "chuo",
        "area": "都心部",
        "latitude": 35.667472,
        "longitude": 139.775342
    },
    {
        "code": "13103",
        "name": "港区",
        "slug": "minato",
        "area": "都心部",
        "latitude": 35.654833,
        "longitude": 139.754636
    },
    {
        "code": "13104",
        "name": "新宿区",
        "slug": "shinjuku",
        "area": "都心部",
        "latitude": 35.690653,
        "longitude": 139.706639
    },
    {
        "code": "13105",
        "name": "文京区",
        "slug": "bunkyo",
        "area": "都心部",
        "latitude": 35.704819,
        "longitude": 139.75545
    },
    {
        "code": "13106",
        "name": "台東区",
        "slug": "taito",
        "area": "23区東部",
        "latitude": 35.709372,
        "longitude": 139.783233
    },
    {
        "code": "13107",
        "name": "墨田区",
        "slug": "sumida",
        "area": "23区東部",
        "latitude": 35.707172,
        "longitude": 139.804797
    },
    {
        "code": "13108",
        "name": "江東区",
        "slug": "koto",
        "area": "23区東部",
        "latitude": 35.669839,
        "longitude": 139.820206
    },
    {
        "code": "13109",
        "name": "品川区",
        "slug": "shinagawa",
        "area": "23区南部",
        "latitude": 35.605661,
        "longitude": 139.733536
    },
    {
        "code": "13110",
        "name": "目黒区",
        "slug": "meguro",
        "area": "23区南部",
        "latitude": 35.638178,
        "longitude": 139.701414
    },
    {
        "code": "13111",
        "name": "大田区",
        "slug": "ota",
        "area": "23区南部",
        "latitude": 35.55815,
        "longitude": 139.719272
    },
    {
        "code": "13112",
        "name": "世田谷区",
        "slug": "setagaya",
        "area": "23区南部",
        "latitude": 35.643336,
        "longitude": 139.656472
    },
    {
        "code": "13113",
        "name": "渋谷区",
        "slug": "shibuya",
        "area": "都心部",
        "latitude": 35.660622,
        "longitude": 139.701458
    },
    {
        "code": "13114",
        "name": "中野区",
        "slug": "nakano",
        "area": "23区西部",
        "latitude": 35.704167,
        "longitude": 139.667064
    },
    {
        "code": "13115",
        "name": "杉並区",
        "slug": "suginami",
        "area": "23区西部",
        "latitude": 35.696342,
        "longitude": 139.639608
    },
    {
        "code": "13116",
        "name": "豊島区",
        "slug": "toshima",
        "area": "23区北部",
        "latitude": 35.729131,
        "longitude": 139.718706
    },
    {
        "code": "13117",
        "name": "北区",
        "slug": "kita",
        "area": "23区北部",
        "latitude": 35.749697,
        "longitude": 139.736644
    },
    {
        "code": "13118",
        "name": "荒川区",
        "slug": "arakawa",
        "area": "23区東部",
        "latitude": 35.732911,
        "longitude": 139.786572
    },
    {
        "code": "13119",
        "name": "板橋区",
        "slug": "itabashi",
        "area": "23区北部",
        "latitude": 35.747936,
        "longitude": 139.712478
    },
    {
        "code": "13120",
        "name": "練馬区",
        "slug": "nerima",
        "area": "23区西部",
        "latitude": 35.732394,
        "longitude": 139.654886
    },
    {
        "code": "13121",
        "name": "足立区",
        "slug": "adachi",
        "area": "23区東部",
        "latitude": 35.772406,
        "longitude": 139.807742
    },
    {
        "code": "13122",
        "name": "葛飾区",
        "slug": "katsushika",
        "area": "23区東部",
        "latitude": 35.740261,
        "longitude": 139.850464
    },
    {
        "code": "13123",
        "name": "江戸川区",
        "slug": "edogawa",
        "area": "23区東部",
        "latitude": 35.703742,
        "longitude": 139.871569
    },
    {
        "code": "13201",
        "name": "八王子市",
        "slug": "hachioji",
        "area": "都下",
        "latitude": 35.663114,
        "longitude": 139.319
    },
    {
        "code": "13202",
        "name": "立川市",
        "slug": "tachikawa",
        "area": "都下",
        "latitude": 35.710761,
        "longitude": 139.411017
    },
    {
        "code": "13203",
        "name": "武蔵野市",
        "slug": "musashino",
        "area": "都下",
        "latitude": 35.714556,
        "longitude": 139.569478
    },
    {
        "code": "13204",
        "name": "三鷹市",
        "slug": "mitaka",
        "area": "都下",
        "latitude": 35.680044,
        "longitude": 139.562939
    },
    {
        "code": "13205",
        "name": "青梅市",
        "slug": "ome",
        "area": "都下",
        "latitude": 35.784778,
        "longitude": 139.278986
    },
    {
        "code": "13206",
        "name": "府中市",
        "slug": "fuchu",
        "area": "都下",
        "latitude": 35.665953,
        "longitude": 139.480819
    },
    {
        "code": "13207",
        "name": "昭島市",
        "slug": "akishima",
        "area": "都下",
        "latitude": 35.702531,
        "longitude": 139.356747
    },
    {
        "code": "13208",
        "name": "調布市",
        "slug": "chofu",
        "area": "都下",
        "latitude": 35.647481,
        "longitude": 139.544206
    },
    {
        "code": "13209",
        "name": "町田市",
        "slug": "machida",
        "area": "都下",
        "latitude": 35.545214,
        "longitude": 139.450069
    },
    {
        "code": "13210",
        "name": "小金井市",
        "slug": "koganei",
        "area": "都下",
        "latitude": 35.696236,
        "longitude": 139.506208
    }
]
Cities of a prefecture — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39971/cities+of+a+prefecture?prefecture=13' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "layouts" parameter of the /rental/search endpoint.
Endpoint ID: 39972
GET https://zylalabs.com/api/15074/suumo+api/39972/rental+layouts
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "one_room",
        "label": "One room (ワンルーム)"
    },
    {
        "value": "1k",
        "label": "1K"
    },
    {
        "value": "1dk",
        "label": "1DK"
    },
    {
        "value": "1ldk",
        "label": "1LDK"
    },
    {
        "value": "2k",
        "label": "2K"
    },
    {
        "value": "2dk",
        "label": "2DK"
    },
    {
        "value": "2ldk",
        "label": "2LDK"
    },
    {
        "value": "3k",
        "label": "3K"
    },
    {
        "value": "3dk",
        "label": "3DK"
    },
    {
        "value": "3ldk",
        "label": "3LDK"
    },
    {
        "value": "4k",
        "label": "4K"
    },
    {
        "value": "4dk",
        "label": "4DK"
    },
    {
        "value": "4ldk",
        "label": "4LDK"
    },
    {
        "value": "5k_plus",
        "label": "5K or more"
    }
]
Rental layouts — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39972/rental+layouts' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "sort" parameter of the /rental/search endpoint.
Endpoint ID: 39973
GET https://zylalabs.com/api/15074/suumo+api/39973/rental+sort+orders
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "recommended",
        "label": "Recommended"
    },
    {
        "value": "newest",
        "label": "Newest listings first"
    },
    {
        "value": "rent_asc",
        "label": "Lowest rent first"
    },
    {
        "value": "rent_desc",
        "label": "Highest rent first"
    },
    {
        "value": "area_desc",
        "label": "Largest area first"
    },
    {
        "value": "area_asc",
        "label": "Smallest area first"
    },
    {
        "value": "building_newest",
        "label": "Newest buildings first"
    }
]
Rental sort orders — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39973/rental+sort+orders' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the rentals of a prefecture of Japan, each room once even when several agencies list it: rental id, title, building type, address, nearest stations with walking or bus time, monthly rent, management fee, deposit, key money, guarantee deposit, layout, area, floor, construction date, direction, move-in date, headline, photo, floor plan and agency. Returns the total number of rentals and the number of pages. All amounts are in yen, areas in square meters.
Endpoint ID: 39974
GET https://zylalabs.com/api/15074/suumo+api/39974/search+rentals
INPUT PARAMETERS

Search rentals — Endpoint Features

Object Description
prefecture Required Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.
cities Optional Optional comma-separated list of up to 20 city codes of the prefecture (e.g. "13101,13102"). Use the /general/cities endpoint to list valid values.
min_rent Optional Optional minimum monthly rent in yen: 30000 to 200000 in steps of 5000, 200000 to 300000 in steps of 10000, or 350000, 400000, 500000 or 1000000.
max_rent Optional Optional maximum monthly rent in yen, with the same steps as "min_rent".
min_area Optional Optional minimum area in square meters: 20 to 70 in steps of 5, or 80, 90 or 100.
max_area Optional Optional maximum area in square meters, with the same steps as "min_area".
max_walk_minutes Optional Optional maximum walk to the station in minutes: 1, 3, 5, 7, 10, 15 or 20.
max_building_age Optional Optional maximum age of the building in years: 0 (new), 1, 3, 5, 7, 10, 15, 20, 25 or 30.
layouts Optional Optional comma-separated list of layouts (e.g. "1k,1ldk"). Use the /rental/layouts endpoint to list valid values.
sort Optional Optional sort order (defaults to "recommended"). Use the /rental/sort-orders endpoint to list valid values.
page Optional Optional page number, 50 rentals per page (defaults to 1).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

prefecture
cities
min_rent
max_rent
min_area
max_area
max_walk_minutes
max_building_age
layouts
sort
page
API EXAMPLE RESPONSE
JSON
{
    "total": 1741,
    "page": 1,
    "total_pages": 35,
    "rentals": [
        {
            "id": "100531490592",
            "url": "https://suumo.jp/chintai/bc_100531490592/",
            "title": "神田 ワンルーム 3階",
            "building_type": "マンション",
            "address": "東京都千代田区東神田1",
            "stations": [
                {
                    "line": "JR山手線",
                    "station": "神田駅",
                    "walk_minutes": 10,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "JR山手線/神田駅 歩10分"
                },
                {
                    "line": "都営浅草線",
                    "station": "東日本橋駅",
                    "walk_minutes": 5,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営浅草線/東日本橋駅 歩5分"
                },
                {
                    "line": "都営新宿線",
                    "station": "馬喰横山駅",
                    "walk_minutes": 2,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営新宿線/馬喰横山駅 歩2分"
                }
            ],
            "rent": 53500,
            "management_fee": 15000,
            "deposit": null,
            "key_money": null,
            "guarantee_deposit": 20000,
            "layout": "ワンルーム",
            "area": 5,
            "floor": "3階/4階建",
            "built": "1979年3月",
            "direction": null,
            "move_in": "即",
            "is_new_building": false,
            "headline": "礼金0敷金0保証人不要 インターネット使用料無料",
            "photo_count": 19,
            "image": "https://img01.suumo.com/front/gazo/fr/bukken/592/100531490592/100531490592_gw.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/fr/bukken/592/100531490592/100531490592_cw.jpg",
            "agency": {
                "name": "(株)東京めぞん",
                "phone": "03-5280-7180"
            },
            "updated": "2026/11/18",
            "next_update": "2026/11/26"
        },
        {
            "id": "100461756799",
            "url": "https://suumo.jp/chintai/bc_100461756799/",
            "title": "インペリアル御茶の水 3階",
            "building_type": "マンション",
            "address": "東京都千代田区神田小川町3",
            "stations": [
                {
                    "line": "都営新宿線",
                    "station": "小川町駅",
                    "walk_minutes": 5,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営新宿線/小川町駅 歩5分"
                },
                {
                    "line": "東京メトロ千代田線",
                    "station": "新御茶ノ水駅",
                    "walk_minutes": 5,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ千代田線/新御茶ノ水駅 歩5分"
                },
                {
                    "line": "都営三田線",
                    "station": "神保町駅",
                    "walk_minutes": 7,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営三田線/神保町駅 歩7分"
                }
            ],
            "rent": 68000,
            "management_fee": 6700,
            "deposit": 68000,
            "key_money": 68000,
            "guarantee_deposit": null,
            "layout": "ワンルーム",
            "area": 14.84,
            "floor": "3階/11階建",
            "built": "1980年8月",
            "direction": null,
            "move_in": "相談",
            "is_new_building": false,
            "headline": "3駅3路線以上利用可能。通勤通学に便利",
            "photo_count": 14,
            "image": "https://img01.suumo.com/front/gazo/fr/bukken/799/100461756799/100461756799_gw.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/fr/bukken/799/100461756799/100461756799_cw.jpg",
            "agency": {
                "name": "(株)きめたハウジング新宿営業所",
                "phone": "03-5369-3196"
            },
            "updated": "2026/11/17",
            "next_update": "2026/12/02"
        },
        {
            "id": "100518316389",
            "url": "https://suumo.jp/chintai/bc_100518316389/",
            "title": "Cooee麹町 4階",
            "building_type": "マンション",
            "address": "東京都千代田区麹町3",
            "stations": [
                {
                    "line": "東京メトロ半蔵門線",
                    "station": "半蔵門駅",
                    "walk_minutes": 4,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ半蔵門線/半蔵門駅 歩4分"
                },
                {
                    "line": "東京メトロ有楽町線",
                    "station": "麹町駅",
                    "walk_minutes": 4,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ有楽町線/麹町駅 歩4分"
                },
                {
                    "line": "JR中央線",
                    "station": "市ケ谷駅",
                    "walk_minutes": 12,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "JR中央線/市ケ谷駅 歩12分"
                }
            ],
            "rent": 70000,
            "management_fee": null,
            "deposit": 70000,
            "key_money": null,
            "guarantee_deposit": null,
            "layout": "ワンルーム",
            "area": 13.37,
            "floor": "4階/5階建",
            "built": "1980年8月",
            "direction": "南",
            "move_in": "即",
            "is_new_building": false,
            "headline": "内見可能・即入居可能です!ハウスメイト管理物件☆",
            "photo_count": 19,
            "image": "https://img01.suumo.com/front/gazo/fr/bukken/389/100518316389/100518316389_gw.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/fr/bukken/389/100518316389/100518316389_cw.jpg",
            "agency": {
                "name": "(株)ハウスメイトショップ新宿店",
                "phone": "0037-60028956"
            },
            "updated": "2026/11/18",
            "next_update": "2026/12/03"
        }
    ]
}
Search rentals — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39974/search+rentals?prefecture=13&cities=13101&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns a single rental in full: building name and type, monthly rent, management fee, deposit, key money, guarantee deposit, other initial costs, insurance, guarantor terms, address, coordinates, nearest stations, layout and room sizes, area, floor, room number, structure, construction date and age, direction, total units, parking, move-in date, contract, conditions, headline, description, features, tags, nearby places, video, agency, listing dates and images. All amounts are in yen, areas in square meters.
Endpoint ID: 39975
GET https://zylalabs.com/api/15074/suumo+api/39975/rental+details
INPUT PARAMETERS

Rental details — Endpoint Features

Object Description
rental_id Required Rental id of the room (e.g. "100531072846"). Use the /rental/search endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

rental_id
API EXAMPLE RESPONSE
JSON
{
    "id": "100531072846",
    "url": "https://suumo.jp/chintai/bc_100531072846/",
    "building_name": "シティタワー九段下",
    "building_type": "マンション",
    "rent": 600000,
    "management_fee": null,
    "deposit": 1200000,
    "key_money": 600000,
    "guarantee_deposit": null,
    "deposit_deduction": null,
    "other_initial_costs": "合計3.5万円(内訳:鍵交換代金3.5万円)",
    "other_costs": "安心入居サポート(月額)0.12万円",
    "insurance": "1.79万円2年",
    "guarantor": "保証会社利用必 初回:月額総家賃の50%~",
    "address": "東京都千代田区飯田橋2",
    "latitude": 35.696347,
    "longitude": 139.753312,
    "stations": [
        {
            "line": "東京メトロ東西線",
            "station": "九段下駅",
            "walk_minutes": 6,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "東京メトロ東西線/九段下駅 歩6分"
        },
        {
            "line": "JR中央線",
            "station": "水道橋駅",
            "walk_minutes": 6,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "JR中央線/水道橋駅 歩6分"
        },
        {
            "line": "東京メトロ有楽町線",
            "station": "飯田橋駅",
            "walk_minutes": 11,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "東京メトロ有楽町線/飯田橋駅 歩11分"
        }
    ],
    "layout": "3LDK",
    "layout_details": "洋7.5 洋5 LDK19.6DK5.1",
    "area": 85.68,
    "floor": 20,
    "floors": "20階/地下2地上24階建",
    "room_number": "2001",
    "structure": "鉄筋コン",
    "built": "2007年3月",
    "age": 20,
    "direction": "南",
    "total_units": 22,
    "parking": "敷地内43000円",
    "move_in": "相談",
    "contract": "定期借家 4年",
    "conditions": "二人入居可",
    "is_new_building": false,
    "headline": "当物件はオンラインまたはお近くの店舗でご相談お申込を承ります",
    "description": "室内見学承ります・お客様のご都合に合わせてオンラインまたはお近くの店舗でご提案可・初期費用分割払い可・クレジットカード利用可・引越業者割引・初期費用のお見積や入居日のご相談もお気軽にお問合せください",
    "remarks": "当物件はオンラインまたはお近くの店舗でご相談お申込を承ります。リライフは首都圏23店舗のネットワークで豊富な物件情報をご提供いたします。当物件に類似した未公開物件のご提案も可能です。お気軽にお問い合わせください。",
    "features": [
        "バストイレ別",
        "バルコニー",
        "エアコン",
        "クロゼット",
        "フローリング",
        "TVインターホン",
        "浴室乾燥機",
        "オートロック",
        "室内洗濯置",
        "シューズボックス",
        "システムキッチン",
        "南向き",
        "追焚機能浴室",
        "角住戸",
        "温水洗浄便座",
        "脱衣所",
        "エレベーター",
        "洗面所独立",
        "駐輪場",
        "宅配ボックス",
        "CATV",
        "2面採光",
        "BS・CS",
        "3口以上コンロ",
        "防犯カメラ",
        "IHクッキングヒーター"
    ],
    "tags": [
        "間取図付き",
        "写真付き",
        "物件動画付き",
        "2階以上",
        "角部屋",
        "南向き",
        "IHコンロ",
        "コンロ2口以上",
        "システムキッチン",
        "バス・トイレ別",
        "温水洗浄便座",
        "浴室乾燥機",
        "追い焚き風呂",
        "インターネット接続可",
        "BSアンテナ",
        "CSアンテナ",
        "ケーブルテレビ",
        "室内洗濯機置場",
        "洗面所独立",
        "フローリング"
    ],
    "nearby": [
        {
            "name": "三徳 飯田橋店(スーパー)まで629m",
            "distance": 629
        },
        {
            "name": "まいばすけっと 神田神保町店(スーパー)まで667m",
            "distance": 667
        },
        {
            "name": "ファミリーマート飯田橋二丁目店(コンビニ)まで120m",
            "distance": 120
        },
        {
            "name": "ローソンLTFエドモント店(コンビニ)まで173m",
            "distance": 173
        },
        {
            "name": "薬局くすりの福太郎飯田橋1丁目店(ドラッグストア)まで157m",
            "distance": 157
        },
        {
            "name": "白洋舎ミスターミニットJR飯田橋駅東口店(その他)まで537m",
            "distance": 537
        }
    ],
    "video_url": "https://suumo.smbb.jp/dvic/smbbmovieplay.php?feed=M18934409M30849-c3V1bW8yLnNtYmIuanA=.xml&akey=18934409M30849-c3V1bW8yLnNtYmIuanA=&siteid=suumo.smbb.jp&config=Msuumoplayer&vkey=bind&viralflag=0",
    "agency": {
        "name": "(株)リライフ四谷店",
        "phone": "03-4296-8023",
        "address": "東京都新宿区四谷1-3-23",
        "opening_hours": "10:00~18:30",
        "closed_on": "火曜・水曜",
        "license": "国土交通大臣(1)第10792号",
        "transaction_type": "仲介"
    },
    "listed": "2026/10/08",
    "updated": "2026/11/18",
    "next_update": "2026/11/26",
    "images": [
        {
            "url": "https://img01.suumo.com/front/gazo/fr/bukken/846/100531072846/100531072846_ro.jpg",
            "caption": "その他部屋・スペース"
        },
        {
            "url": "https://img01.suumo.com/front/gazo/fr/bukken/846/100531072846/100531072846_co.jpg",
            "caption": "間取り図"
        }
    ]
}
Rental details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39975/rental+details?rental_id=100531072846' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "property_type" parameter of the /sale/search and /sale/details endpoints.
Endpoint ID: 39976
GET https://zylalabs.com/api/15074/suumo+api/39976/sale+property+types
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "new_condo",
        "label": "New condominium (新築マンション)"
    },
    {
        "value": "used_condo",
        "label": "Used condominium (中古マンション)"
    },
    {
        "value": "new_house",
        "label": "New house (新築一戸建て)"
    },
    {
        "value": "used_house",
        "label": "Used house (中古一戸建て)"
    },
    {
        "value": "land",
        "label": "Land (土地)"
    }
]
Sale property types — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39976/sale+property+types' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "layouts" parameter of the /sale/search endpoint.
Endpoint ID: 39977
GET https://zylalabs.com/api/15074/suumo+api/39977/sale+layouts
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "one_room",
        "label": "One room (ワンルーム)"
    },
    {
        "value": "1_room",
        "label": "1K / 1DK / 1LDK"
    },
    {
        "value": "2_rooms",
        "label": "2K / 2DK / 2LDK"
    },
    {
        "value": "3_rooms",
        "label": "3K / 3DK / 3LDK"
    },
    {
        "value": "4_rooms",
        "label": "4K / 4DK / 4LDK"
    },
    {
        "value": "5_rooms_plus",
        "label": "5K or more"
    }
]
Sale layouts — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39977/sale+layouts' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "sort" parameter of the /sale/search endpoint.
Endpoint ID: 39978
GET https://zylalabs.com/api/15074/suumo+api/39978/sale+sort+orders
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "recommended",
        "label": "Recommended"
    },
    {
        "value": "newest",
        "label": "Newest listings first"
    },
    {
        "value": "price_asc",
        "label": "Lowest price first"
    },
    {
        "value": "price_desc",
        "label": "Highest price first"
    },
    {
        "value": "area_desc",
        "label": "Largest area first"
    },
    {
        "value": "area_asc",
        "label": "Smallest area first"
    },
    {
        "value": "building_newest",
        "label": "Newest buildings first"
    },
    {
        "value": "building_oldest",
        "label": "Oldest buildings first"
    }
]
Sale sort orders — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39978/sale+sort+orders' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the new and used condominiums, new and used houses or land for sale in a prefecture of Japan, each with its property id, name, headline, price (or price range), management fee, address, coordinates, nearest stations with walking or bus time, layout, floor, building, land and balcony area, building coverage, construction date, direction, move-in date, units for sale, photo, floor plan and company. Returns the total number of matches and the number of pages. All amounts are in yen, areas in square meters.
Endpoint ID: 39979
GET https://zylalabs.com/api/15074/suumo+api/39979/search+properties+for+sale
INPUT PARAMETERS

Search properties for sale — Endpoint Features

Object Description
property_type Required Property type (e.g. "used_condo"). Use the /sale/property-types endpoint to list valid values.
prefecture Required Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.
cities Optional Optional comma-separated list of up to 20 city codes of the prefecture (e.g. "13101,13102"). Use the /general/cities endpoint to list valid values.
min_price Optional Optional minimum price in yen: 5000000 to 80000000 in steps of 5000000, or 90000000 or 100000000.
max_price Optional Optional maximum price in yen, with the same steps as "min_price" plus 120000000.
min_area Optional Optional minimum floor area of a condominium (20, 25, 30, then 40 to 100 in steps of 10) or building area of a house (50 to 100 in steps of 10), in square meters.
max_area Optional Optional maximum floor area of a condominium or building area of a house, with the same steps as "min_area".
min_land_area Optional Optional minimum land area of a house or a plot of land in square meters: 60 to 150 in steps of 10.
max_land_area Optional Optional maximum land area of a house or a plot of land in square meters: 60 to 150 in steps of 10.
max_walk_minutes Optional Optional maximum walk to the station in minutes: 1, 3, 5, 7, 10, 15 or 20.
max_building_age Optional Optional maximum age of a used condominium or house in years: 1, 3, 5, 7, 10, 15, 20, 25 or 30.
layouts Optional Optional comma-separated list of layouts of a condominium or house (e.g. "2_rooms,3_rooms"). Use the /sale/layouts endpoint to list valid values.
sort Optional Optional sort order (defaults to "recommended"). Use the /sale/sort-orders endpoint to list valid values.
page Optional Optional page number, 50 properties per page (defaults to 1).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

property_type
prefecture
cities
min_price
max_price
min_area
max_area
min_land_area
max_land_area
max_walk_minutes
max_building_age
layouts
sort
page
API EXAMPLE RESPONSE
JSON
{
    "total": 670,
    "page": 1,
    "total_pages": 14,
    "properties": [
        {
            "id": "21676696",
            "property_type": "used_condo",
            "url": "https://suumo.jp/ms/chuko/tokyo/sc_chiyoda/nc_21676696/",
            "name": "九段アビタシオン",
            "headline": "【当社売主】新規リノベ×夜間オートロック×駅チカ",
            "price": "2180万円",
            "min_price": 21800000,
            "max_price": 21800000,
            "management_fee": 6255,
            "address": "東京都千代田区神田神保町3-6-6",
            "latitude": 35.6935416792077,
            "longitude": 139.75640001522902,
            "stations": [
                {
                    "line": "東京メトロ半蔵門線",
                    "station": "九段下",
                    "walk_minutes": 3,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ半蔵門線「九段下」歩3分"
                },
                {
                    "line": "都営三田線",
                    "station": "神保町",
                    "walk_minutes": 6,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営三田線「神保町」歩6分"
                },
                {
                    "line": "都営三田線",
                    "station": "水道橋",
                    "walk_minutes": 11,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営三田線「水道橋」歩11分"
                }
            ],
            "layout": "1K",
            "floor_area": {
                "min": 15.94,
                "max": 15.94,
                "text": "15.94平米(壁芯)"
            },
            "building_area": null,
            "land_area": null,
            "balcony_area": 1.52,
            "building_coverage": null,
            "built": "1978年11月",
            "direction": "南西",
            "move_in": "相談",
            "units_for_sale": "1戸",
            "total_units": null,
            "image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/696/21676696/21676696_0016.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/696/21676696/21676696_0025.jpg",
            "company": {
                "name": "(株)デバインコーポレーション",
                "phone": "0120-757605",
                "transaction_type": "売主"
            },
            "updated": null
        },
        {
            "id": "21457575",
            "property_type": "used_condo",
            "url": "https://suumo.jp/ms/chuko/tokyo/sc_chiyoda/nc_21457575/",
            "name": "グランスイートTOKYOマークス",
            "headline": "◆丸の内や大手町、日本橋が徒歩圏に広がる都心型レジデンス",
            "price": "3680万円",
            "min_price": 36800000,
            "max_price": 36800000,
            "management_fee": 10900,
            "address": "東京都千代田区神田多町2-8-20",
            "latitude": 35.69138695682755,
            "longitude": 139.7725091820054,
            "stations": [
                {
                    "line": "東京メトロ丸ノ内線",
                    "station": "淡路町",
                    "walk_minutes": 2,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ丸ノ内線「淡路町」歩2分"
                },
                {
                    "line": "JR山手線",
                    "station": "神田",
                    "walk_minutes": 4,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "JR山手線「神田」歩4分"
                },
                {
                    "line": "JR総武線",
                    "station": "御茶ノ水",
                    "walk_minutes": 10,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "JR総武線「御茶ノ水」歩10分"
                }
            ],
            "layout": "1K",
            "floor_area": {
                "min": 25.98,
                "max": 25.98,
                "text": "25.98平米(壁芯)"
            },
            "building_area": null,
            "land_area": null,
            "balcony_area": 2.69,
            "building_coverage": null,
            "built": "2004年2月",
            "direction": "東",
            "move_in": "即引渡可",
            "units_for_sale": "1戸",
            "total_units": null,
            "image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/575/21457575/21457575_0001.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/575/21457575/21457575_0004.jpg",
            "company": {
                "name": "(株)長谷工リアルエステート上野センター",
                "phone": "0120-315875",
                "transaction_type": "仲介"
            },
            "updated": null
        },
        {
            "id": "21790052",
            "property_type": "used_condo",
            "url": "https://suumo.jp/ms/chuko/tokyo/sc_chiyoda/nc_21790052/",
            "name": "パークウェル神田EAST",
            "headline": "大京穴吹不動産が売主のリノベーション物件×4階の角住戸",
            "price": "4298万円",
            "min_price": 42980000,
            "max_price": 42980000,
            "management_fee": 9640,
            "address": "東京都千代田区岩本町3-11-2",
            "latitude": 35.69342783249381,
            "longitude": 139.7812083429131,
            "stations": [
                {
                    "line": "東京メトロ日比谷線",
                    "station": "秋葉原",
                    "walk_minutes": 4,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "東京メトロ日比谷線「秋葉原」歩4分"
                },
                {
                    "line": "都営新宿線",
                    "station": "岩本町",
                    "walk_minutes": 4,
                    "bus_minutes": null,
                    "bus_stop_walk_minutes": null,
                    "text": "都営新宿線「岩本町」歩4分"
                }
            ],
            "layout": "1DK",
            "floor_area": {
                "min": 28.78,
                "max": 28.78,
                "text": "28.78平米(壁芯)"
            },
            "building_area": null,
            "land_area": null,
            "balcony_area": 8.82,
            "building_coverage": null,
            "built": "2002年2月",
            "direction": "西",
            "move_in": "相談",
            "units_for_sale": "1戸",
            "total_units": null,
            "image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/052/21790052/21790052_0009.jpg",
            "floor_plan_image": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/052/21790052/21790052_0002.jpg",
            "company": {
                "name": "(株)大京穴吹不動産飯田橋店/電話受付→本社:東京",
                "phone": "0120-984841",
                "transaction_type": "売主"
            },
            "updated": null
        }
    ]
}
Search properties for sale — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39979/search+properties+for+sale?property_type=used_condo&prefecture=13&cities=13101&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns a single property for sale in full: name, headline and description, price, management fee, repair reserve fund, address, coordinates, nearest stations, layout, floor, building, land and other areas, construction date, direction, structure, units, land rights and category, zoning, building coverage, road access, parking, handover, renovation, builder, restrictions, features, floor plans, nearby places, company and agent, listing dates and images. New condominiums also come with their sales schedule, site and total floor area, management, showroom and contact. All amounts are in yen, areas in square meters.
Endpoint ID: 39980
GET https://zylalabs.com/api/15074/suumo+api/39980/sale+details
INPUT PARAMETERS

Sale details — Endpoint Features

Object Description
property_type Required Property type of the property (e.g. "used_condo"). Use the /sale/property-types endpoint to list valid values.
property_id Required Property id (e.g. "21676696"). Use the /sale/search endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

property_type
property_id
API EXAMPLE RESPONSE
JSON
{
    "id": "21676696",
    "property_type": "used_condo",
    "url": "https://suumo.jp/jj/bukken/shosai/JJ010FJ100/?ar=030&bs=011&nc=21676696",
    "name": "九段アビタシオン",
    "headline": "【当社売主】新規リノベ×夜間オートロック×駅チカ",
    "description": "☆新規リノベーション(2026年11月下旬完成予定)☆\nメーカー、仕様、色合い、細かく説明いたします。\nご見学お待ちしております♪\n【リノベーション工事一覧】\nシステムキッチン 新規交換\nユニットバス 新規交換\nトイレ 新規交換\nフローリング 貼替\n建具 交換\n電気温水器 交換\n・・・etc",
    "price": "2180万円",
    "min_price": 21800000,
    "max_price": 21800000,
    "management_fee": 6255,
    "repair_reserve_fund": 6255,
    "other_costs": null,
    "address": "東京都千代田区神田神保町3-6-6",
    "latitude": 35.693542,
    "longitude": 139.7564,
    "stations": [
        {
            "line": "東京メトロ半蔵門線",
            "station": "九段下",
            "walk_minutes": 3,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "東京メトロ半蔵門線「九段下」歩3分"
        },
        {
            "line": "都営三田線",
            "station": "神保町",
            "walk_minutes": 6,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "都営三田線「神保町」歩6分"
        },
        {
            "line": "都営三田線",
            "station": "水道橋",
            "walk_minutes": 11,
            "bus_minutes": null,
            "bus_stop_walk_minutes": null,
            "text": "都営三田線「水道橋」歩11分"
        }
    ],
    "layout": "1K",
    "floor_area": {
        "min": 15.94,
        "max": 15.94,
        "text": "15.94m²(壁芯)"
    },
    "building_area": null,
    "land_area": null,
    "other_area": "バルコニー面積:1.52m²",
    "built": "1978年11月",
    "floor": "7階",
    "direction": "南西",
    "structure": "SRC8階建",
    "units_for_sale": "1戸",
    "total_units": null,
    "land_rights": "所有権",
    "land_category": null,
    "land_status": null,
    "zoning": "商業",
    "building_coverage": null,
    "building_conditions": null,
    "road_access": null,
    "parking": "無",
    "handover": "相談",
    "renovation": "2026年11月完了\n水回り設備交換:キッチン・浴室・トイレ\n内装リフォーム:壁・床・全室\nその他:電気温水器等\n※年月は一番古いリフォーム箇所を表します",
    "builder": "(株)浅沼組",
    "restrictions": null,
    "notes": "担当者:水野 祐一朗",
    "event": "現地見学会(事前に必ずお問い合わせください)\n日程/毎週土日祝\n時間/10:00~19:00",
    "features": [
        "年内引渡可",
        "2沿線以上利用可",
        "スーパー 徒歩10分以内",
        "市街地が近い",
        "内装リフォーム",
        "陽当り良好",
        "駅まで平坦",
        "閑静な住宅地",
        "総合病院 徒歩10分以内",
        "高層階",
        "フローリング張替",
        "TVモニタ付インターホン",
        "緑豊かな住宅地",
        "都市近郊",
        "通風良好",
        "全居室フローリング",
        "南西向き",
        "IHクッキングヒーター",
        "BS・CS・CATV",
        "小学校 徒歩10分以内",
        "大型タウン内",
        "平坦地",
        "エレベーター",
        "駐輪場",
        "バイク置場",
        "整備された歩道"
    ],
    "floor_plans": [],
    "nearby": [
        {
            "name": "まいばすけっと九段北1丁目店",
            "type": "スーパー",
            "distance": 220,
            "walk_minutes": 3
        },
        {
            "name": "成城石井神保町店",
            "type": "スーパー",
            "distance": 233,
            "walk_minutes": 3
        },
        {
            "name": "まいばすけっと神田神保町店",
            "type": "スーパー",
            "distance": 280,
            "walk_minutes": 4
        },
        {
            "name": "ローソン九段北一丁目店",
            "type": "コンビニ",
            "distance": 167,
            "walk_minutes": 3
        },
        {
            "name": "セブンイレブン神田神保町3丁目店",
            "type": "コンビニ",
            "distance": 139,
            "walk_minutes": 2
        },
        {
            "name": "ファミリーマート専大通り店",
            "type": "コンビニ",
            "distance": 200,
            "walk_minutes": 3
        }
    ],
    "company": {
        "name": "(株)デバインコーポレーション",
        "phone": "0120-757605",
        "address": null,
        "license": "東京都知事(5)第082119号",
        "transaction_type": "売主",
        "details": "<売主>\n東京都知事(5)第082119号\n(公社)東京都宅地建物取引業協会会員 (公社)首都圏不動産公正取引協議会加盟 / (一社)全国住宅産業協会会員 (公社)首都圏不動産公正取引協議会加盟\n(株)デバインコーポレーション\n〒105-0011 東京都港区芝公園2-6-15"
    },
    "agent": "水野 祐一朗",
    "updated": "2026/11/16",
    "next_update": "2026/11/24",
    "images": [
        {
            "url": "https://img01.suumo.com/front/gazo/bukken/030/N010000/img/696/21676696/21676696_0016.jpg",
            "caption": "穏やかな風と陽光を導き、プライバシーに配慮された設計プランを採用し、居住性を一段と心地よいものにしています。周辺環境とのコラボレーションにより明るく開放的な空間を演出。",
            "category": "現地外観写真"
        }
    ]
}
Sale details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15074/suumo+api/39980/sale+details?property_type=used_condo&property_id=21676696' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the SUUMO API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

Starts at
$10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Japanese real estate: prefectures and cities, rental search with rent, area, walking time and layout filters, rental details, condominium, house and land sale search and details.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs