SUUMO API

API ID 15074

日本房地产:都道府县和城市,按租金、面积、步行时间和户型筛选的租赁搜索,租赁详情,公寓、房屋和土地的出售搜索及详情

API 文档

端点

请求
列出了日本的都道府县及其“都道府县”参数接受的代码、英语和日语名称以及地区
Endpoint ID: 39970
GET https://zylalabs.com/api/15074/suumo+api/39970/prefectures
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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"
    }
]
行政区 — 代码片段

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


    
请求
列出一个接受"城市"参数的行政区的城市、区和乡镇,它们的日文名、罗马音名、所属的行政区以及它们的坐标
Endpoint ID: 39971
GET https://zylalabs.com/api/15074/suumo+api/39971/cities+of+a+prefecture
输入参数

地方政府的城市 — 端点功能

对象 描述
prefecture 必需 Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.

剩余免费测试请求:3 / 3。


输入参数

prefecture
API 示例响应
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
    }
]
地方政府的城市 — 代码片段

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


    
请求
列出/rental/search端点的"layouts"参数接受的值
Endpoint ID: 39972
GET https://zylalabs.com/api/15074/suumo+api/39972/rental+layouts
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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"
    }
]
租赁布局 — 代码片段

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


    
请求
列出/rental/search端点的“sort”参数接受的值
Endpoint ID: 39973
GET https://zylalabs.com/api/15074/suumo+api/39973/rental+sort+orders
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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"
    }
]
租赁排序 — 代码片段

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


    
请求
列出日本某个地区的租赁信息,每个房间即使有多个中介列出也只列一次:租赁编号 标题 建筑类型 地址 最近车站及步行或公交时间 月租金 管理费 押金 键钱 保证金 户型 面积 楼层 建筑日期 朝向 入住日期 标题 图片 平面图 和中介 返回租赁总数和页数 所有金额均以日元计面 积以平方米计
Endpoint ID: 39974
GET https://zylalabs.com/api/15074/suumo+api/39974/search+rentals
输入参数

搜索租赁 — 端点功能

对象 描述
prefecture 必需 Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.
cities 可选 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 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 maximum monthly rent in yen, with the same steps as "min_rent".
min_area 可选 Optional minimum area in square meters: 20 to 70 in steps of 5, or 80, 90 or 100.
max_area 可选 Optional maximum area in square meters, with the same steps as "min_area".
max_walk_minutes 可选 Optional maximum walk to the station in minutes: 1, 3, 5, 7, 10, 15 or 20.
max_building_age 可选 Optional maximum age of the building in years: 0 (new), 1, 3, 5, 7, 10, 15, 20, 25 or 30.
layouts 可选 Optional comma-separated list of layouts (e.g. "1k,1ldk"). Use the /rental/layouts endpoint to list valid values.
sort 可选 Optional sort order (defaults to "recommended"). Use the /rental/sort-orders endpoint to list valid values.
page 可选 Optional page number, 50 rentals per page (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

prefecture
cities
min_rent
max_rent
min_area
max_area
max_walk_minutes
max_building_age
layouts
sort
page
API 示例响应
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"
        }
    ]
}
搜索租赁 — 代码片段

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' 


    
请求
返回完整的租赁信息:建筑名称和类型、月租金、管理费、押金、钥匙费、担保金、其他初始费用、保险、担保人条款、地址、坐标、最近车站、布局和房间大小、面积、楼层、房间号、结构、建筑日期和年龄、方向、总单元、停车位、入住日期、合同、条件、标题、描述、特点、标签、附近地点、视频、代理机构、挂牌日期和图片。所有金额均为日元,面积以平方米为单位
Endpoint ID: 39975
GET https://zylalabs.com/api/15074/suumo+api/39975/rental+details
输入参数

租赁详情 — 端点功能

对象 描述
rental_id 必需 Rental id of the room (e.g. "100531072846"). Use the /rental/search endpoint to list valid values.

剩余免费测试请求:3 / 3。


输入参数

rental_id
API 示例响应
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": "間取り図"
        }
    ]
}
租赁详情 — 代码片段

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


    
请求
列出了/sale/search和/sale/details端点的"property_type"参数接受的值
Endpoint ID: 39976
GET https://zylalabs.com/api/15074/suumo+api/39976/sale+property+types
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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 (土地)"
    }
]
出售物业类型 — 代码片段

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


    
请求
列出/sale/search端点的"layouts"参数接受的值
Endpoint ID: 39977
GET https://zylalabs.com/api/15074/suumo+api/39977/sale+layouts
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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"
    }
]
促销布局 — 代码片段

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


    
请求
列出/sale/search端点的"sort"参数接受的值
Endpoint ID: 39978
GET https://zylalabs.com/api/15074/suumo+api/39978/sale+sort+orders
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
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"
    }
]
销售排序订单 — 代码片段

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


    
请求
列出日本某个地区的待售新建和二手公寓、新建和二手房或土地,每个都有其物业ID、名称、标题、价格(或价格范围)、管理费、地址、坐标、最近车站的步行或公交时间、户型、楼层、建筑、土地和阳台面积、建筑覆盖率、建造日期、朝向、入住日期、待售单元、照片、平面图和公司。返回匹配的总数和页数。所有金额均为日元,面积以平方米计算
Endpoint ID: 39979
GET https://zylalabs.com/api/15074/suumo+api/39979/search+properties+for+sale
输入参数

搜索待售房产 — 端点功能

对象 描述
property_type 必需 Property type (e.g. "used_condo"). Use the /sale/property-types endpoint to list valid values.
prefecture 必需 Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.
cities 可选 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 minimum price in yen: 5000000 to 80000000 in steps of 5000000, or 90000000 or 100000000.
max_price 可选 Optional maximum price in yen, with the same steps as "min_price" plus 120000000.
min_area 可选 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 maximum floor area of a condominium or building area of a house, with the same steps as "min_area".
min_land_area 可选 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 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 maximum walk to the station in minutes: 1, 3, 5, 7, 10, 15 or 20.
max_building_age 可选 Optional maximum age of a used condominium or house in years: 1, 3, 5, 7, 10, 15, 20, 25 or 30.
layouts 可选 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 sort order (defaults to "recommended"). Use the /sale/sort-orders endpoint to list valid values.
page 可选 Optional page number, 50 properties per page (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

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 示例响应
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
        }
    ]
}
搜索待售房产 — 代码片段

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' 


    
请求
返回一个完整的待售房产信息:名称、标题和描述、价格、管理费、维修储备基金、地址、坐标、最近的车站、布局、楼层、建筑、土地和其他区域、建造日期、朝向、结构、单元、土地权益和类别、分区、建筑覆盖率、道路通达性、停车场、交接、装修、建筑商、限制、特点、户型、附近地点、公司和代理、上市日期和图片。新公寓还附带其销售计划、现场和总建筑面积、管理、样板房和联系方式。所有金额均为日元,面积以平方米为单位
Endpoint ID: 39980
GET https://zylalabs.com/api/15074/suumo+api/39980/sale+details
输入参数

销售详情 — 端点功能

对象 描述
property_type 必需 Property type of the property (e.g. "used_condo"). Use the /sale/property-types endpoint to list valid values.
property_id 必需 Property id (e.g. "21676696"). Use the /sale/search endpoint to list valid values.

剩余免费测试请求:3 / 3。


输入参数

property_type
property_id
API 示例响应
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": "現地外観写真"
        }
    ]
}
销售详情 — 代码片段

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 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 SUUMO API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

日本房地产:各县和城市,带租金、面积、步行时间和格局筛选的租赁搜索,租赁详情,公寓、住房和土地出售搜索及详情

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API