SUUMO API

API ID 15074

Imóveis japoneses: prefeituras e cidades, busca de aluguel com filtros de preço, área, tempo de caminhada e layout, detalhes do aluguel, pesquisa e detalhes de venda de condomínio, casa e terreno

Documentação da API

Endpoints

Requisição
Lista as prefeituras do Japão com o código aceito pelo parâmetro "prefeitura" seus nomes em inglês e japonês e sua região
Endpoint ID: 39970
GET https://zylalabs.com/api/15074/suumo+api/39970/prefectures
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Prefeituras — TRECHOS DE CÓDIGO

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


    
Requisição
Lista as cidades, bairros e distritos de uma prefeitura com o código aceito pelo parâmetro "cidades", seu nome em japonês, nome romanizado, a parte da prefeitura à qual pertencem e suas coordenadas
Endpoint ID: 39971
GET https://zylalabs.com/api/15074/suumo+api/39971/cities+of+a+prefecture
PARÂMETROS DE ENTRADA

Cidades de uma prefeitura — Recursos do endpoint

Objeto Descrição
prefecture Obrigatório Prefecture code (e.g. "13" for Tokyo). Use the /general/prefectures endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

prefecture
RESPOSTA DE EXEMPLO DA 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
    }
]
Cidades de uma prefeitura — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "layouts" do endpoint /rental/search
Endpoint ID: 39972
GET https://zylalabs.com/api/15074/suumo+api/39972/rental+layouts
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Layouts de locação — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "sort" do endpoint /rental/search
Endpoint ID: 39973
GET https://zylalabs.com/api/15074/suumo+api/39973/rental+sort+orders
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Ordens de classificação de aluguel — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os aluguéis de uma prefeitura do Japão cada quarto uma vez mesmo quando várias agências o listam id do aluguel título tipo de edifício endereço estações mais próximas com tempo a pé ou de ônibus aluguel mensal taxa de administração depósito taxa de chave depósito de garantia layout área andar data de construção direção data de entrada título foto planta baixa e agência Retorna o número total de aluguéis e o número de páginas Todos os valores estão em ienes áreas em metros quadrados
Endpoint ID: 39974
GET https://zylalabs.com/api/15074/suumo+api/39974/search+rentals
PARÂMETROS DE ENTRADA

Buscar alugueis — Recursos do endpoint

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

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

prefecture
cities
min_rent
max_rent
min_area
max_area
max_walk_minutes
max_building_age
layouts
sort
page
RESPOSTA DE EXEMPLO DA 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"
        }
    ]
}
Buscar alugueis — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna um único aluguel completo: nome e tipo do edifício, aluguel mensal, taxa de administração, depósito, valor da chave, depósito de garantia, outros custos iniciais, seguro, termos do fiador, endereço, coordenadas, estações mais próximas, layout e tamanhos dos quartos, área, andar, número do quarto, estrutura, data de construção e idade, direção, unidades totais, estacionamento, data de mudança, contrato, condições, título, descrição, características, etiquetas, lugares próximos, vídeo, agência, datas e imagens do anúncio. Todos os valores estão em ienes, áreas em metros quadrados
Endpoint ID: 39975
GET https://zylalabs.com/api/15074/suumo+api/39975/rental+details
PARÂMETROS DE ENTRADA

Detalhes de aluguel — Recursos do endpoint

Objeto Descrição
rental_id Obrigatório Rental id of the room (e.g. "100531072846"). Use the /rental/search endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

rental_id
RESPOSTA DE EXEMPLO DA 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": "間取り図"
        }
    ]
}
Detalhes de aluguel — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "property_type" dos endpoints /sale/search e /sale/details
Endpoint ID: 39976
GET https://zylalabs.com/api/15074/suumo+api/39976/sale+property+types
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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 (土地)"
    }
]
Tipos de propriedades à venda — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "layouts" do endpoint /sale/search
Endpoint ID: 39977
GET https://zylalabs.com/api/15074/suumo+api/39977/sale+layouts
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Layouts de venda — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "sort" do endpoint /sale/search
Endpoint ID: 39978
GET https://zylalabs.com/api/15074/suumo+api/39978/sale+sort+orders
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
    }
]
Ordens de classificação de venda — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os condomínios novos e usados, casas novas e usadas ou terrenos à venda em uma prefeitura do Japão, cada um com seu id de propriedade, nome, título, preço (ou faixa de preço), taxa de administração, endereço, coordenadas, estações mais próximas com tempo a pé ou de ônibus, disposição, andar, edifício, área do terreno e da varanda, cobertura do edifício, data de construção, direção, data de mudança, unidades à venda, foto, planta do andar e empresa. Retorna o número total de correspondências e o número de páginas. Todos os valores estão em ienes, áreas em metros quadrados
Endpoint ID: 39979
GET https://zylalabs.com/api/15074/suumo+api/39979/search+properties+for+sale
PARÂMETROS DE ENTRADA

Buscar propriedades à venda — Recursos do endpoint

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

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

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
RESPOSTA DE EXEMPLO DA 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
        }
    ]
}
Buscar propriedades à venda — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna uma única propriedade à venda na íntegra: nome, título e descrição, preço, taxa de administração, fundo de reserva para reparos, endereço, coordenadas, estações mais próximas, layout, andares, edifício, terreno e outras áreas, data de construção, direção, estrutura, unidades, direitos de terreno e categoria, zoneamento, taxa de ocupação, acesso à estrada, estacionamento, entrega, reforma, construtor, restrições, características, plantas baixas, lugares próximos, empresa e agente, datas de listagem e imagens. Novos condomínios também vêm com seu cronograma de vendas, local e área total do andar, gestão, showroom e contato. Todos os valores estão em ienes, áreas em metros quadrados
Endpoint ID: 39980
GET https://zylalabs.com/api/15074/suumo+api/39980/sale+details
PARÂMETROS DE ENTRADA

Detalhes da venda — Recursos do endpoint

Objeto Descrição
property_type Obrigatório Property type of the property (e.g. "used_condo"). Use the /sale/property-types endpoint to list valid values.
property_id Obrigatório Property id (e.g. "21676696"). Use the /sale/search endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

property_type
property_id
RESPOSTA DE EXEMPLO DA 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": "現地外観写真"
        }
    ]
}
Detalhes da venda — TRECHOS DE CÓDIGO

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' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a SUUMO API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

Imóveis japoneses: prefeituras e cidades, busca de aluguel com filtros de aluguel, área, tempo de caminhada e layout, detalhes do aluguel, busca e detalhes de venda de condomínio, casa e terreno

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas