Suumo Japan Scraper

Slug: fatihtahta/suumo-japan-scraper

Overview

Suumo Japan Scraper collects structured real estate listing data from Suumo.jp, including property details, pricing, location, transport access, layout, images, contact information, amenities, and listing metadata. Suumo.jp is a major Japanese real estate marketplace, making its public listing data useful for market analysis, property research, monitoring, and operational reporting. The actor turns search pages, category pages, borough result pages, and direct listing URLs into repeatable JSON output that can be used by teams and automated systems. It is designed for consistent recurring data acquisition, with configurable collection limits and optional richer listing details. The result is a dependable workflow for collecting public property data without manual browsing or copy-paste work.

Why Use This Actor

• Market research and analytics teams: build structured extraction workflows for rent, availability, geography, building type, amenities, and market movement across selected Suumo.jp result pages.
• Product and content teams: normalize property listing data for internal catalogs, map experiences, editorial review, or location-aware product features.
• Developers and data engineering teams: feed downstream systems with predictable JSON records that support ETL jobs, warehouses, search indexes, and enrichment pipelines.
• Lead generation and enrichment teams: collect public agency, contact, location, and property attributes for qualification, segmentation, and operational follow-up.
• Monitoring and competitive tracking teams: schedule repeatable collection to observe listing changes, availability signals, pricing movement, and regional coverage over time.

Common Use Cases

• Market intelligence: monitor rental supply, prices, building age, floor plans, amenities, and geographic distribution across target areas.
• Lead generation: build targeted lists of public property listings and associated real estate agencies for legitimate business workflows.
• Competitive monitoring: track changes in available listings, pricing, listing descriptions, contact details, and property presentation.
• Catalog and directory building: populate internal real estate databases with normalized public listing records.
• Data enrichment: add current public rent, address, layout, access, media, and agency attributes to CRM, BI, or analytics datasets.
• Recurring reporting: schedule periodic runs for dashboards, alerts, market snapshots, and trend analysis.

Quick Start

1. Choose one or more Suumo.jp URLs that define the listings you want to collect, such as search result, category, borough result, or direct listing URLs.
2. Set a small limit for the first validation run, such as 10 or 25.
3. Choose whether to enable enrich_data when you need expanded property details beyond standard listing fields.
4. Run the actor in Apify Console.
5. Inspect the first dataset records to confirm the output shape matches your use case.
6. Increase the limit, add more URLs, or schedule the actor after validating the dataset.

Input Parameters

The actor accepts Suumo.jp URLs, a per-URL result limit, and an enrichment option.

Parameter	Type	Description	Default
startUrls	array of strings	One or more public Suumo.jp URLs. Search, category, and borough result pages collect matching listings from that page flow; direct listing URLs collect the specific property pages provided.	–
limit	integer	Maximum number of listings to save for each input URL. Minimum value is 10.	50000
enrich_data	boolean	When enabled, records can include expanded property details such as additional amenities, summary fields, gallery images, and contact information when available. Turn it off for faster standard listing collection.	true

Choosing Inputs

Use startUrls to control collection scope. A search result or borough URL is best for collecting a market segment, while a direct listing URL is best when you already know the exact property page to collect. Broader Suumo.jp URLs improve discovery, while narrower URLs produce cleaner, more targeted datasets. Start with a small limit to validate record quality and increase it after confirming that the results match your intended geography, category, or segment. Enable enrich_data when downstream workflows need fuller property, media, feature, and contact information.

Example Inputs

Broad Discovery With A Conservative Limit

{
  "startUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=12&sc=12223&cb=0.0&ct=9999999&et=9999999&cn=9999999&mb=0&mt=9999999&shkr1=03&shkr2=03&shkr3=03&shkr4=03&fw2="
  ],
  "limit": 25,
  "enrich_data": true
}

Direct Listing Collection

{
  "startUrls": [
    "https://suumo.jp/chintai/jnc_000107533873/?bc=100509695377"
  ],
  "limit": 10,
  "enrich_data": true
}

Faster Standard Listing Validation

{
  "startUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=12&sc=12101&sc=12104&cb=0.0&ct=9999999&et=9999999&cn=9999999&mb=0&mt=9999999&shkr1=03&shkr2=03&shkr3=03&shkr4=03&fw2=&srch_navi=1"
  ],
  "limit": 10,
  "enrich_data": false
}

Output

Output Destination

The actor writes results to an Apify dataset as JSON records. The dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs with minimal post-processing.

When multiple entity types or record shapes exist, this README documents each shape separately based on the provided Example Output.

Record Envelope And Stable Identifiers

Each output record represents a Suumo.jp rental listing. The strongest recommended idempotency key is property.building_id or property.unit_id when present; url is also a stable fallback for deduplication and repeated syncs. For warehouse upserts, use property.unit_id when available and fall back to url if the listing identifier is missing. Stable identifiers make records easier to merge, deduplicate, and sync across repeated runs. source_context.source_url records the input or search context associated with the saved listing and can be useful when tracing records back to a collection scope.

Examples

Example: rental listing (listing_type = "rental")

{
  "url": "https://suumo.jp/chintai/jnc_000107533873/?bc=100509695377",
  "listing_type": "rental",
  "title": "リブリ・都",
  "property": {
    "building_id": "100509695377",
    "unit_id": "100509695377",
    "name": "リブリ・都",
    "building_name": "リブリ・都",
    "property_type": "賃貸アパート"
  },
  "pricing": {
    "rent": "6.9万円",
    "management_fee": "4000円",
    "deposit": "-",
    "key_money": "6.9万円",
    "guarantee": "-",
    "amortization": "-"
  },
  "location": {
    "address": "千葉県千葉市中央区椿森２"
  },
  "transport": [
    "ＪＲ総武本線/東千葉駅 歩4分",
    "千葉都市モノレール/千葉駅 歩15分",
    "千葉都市モノレール/千葉公園駅 歩5分"
  ],
  "layout": {
    "floor": "1階",
    "floor_plan": "1K",
    "area": "26.08m2",
    "built": "築5年",
    "building_meta": [
      "築5年",
      "3階建"
    ]
  },
  "media": {
    "primary_image": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_co.jpg",
    "building_image": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_gw.jpg",
    "images": [
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_go.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_co.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_ro.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_2o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_1o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_5o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_8o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_6o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_7o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_10o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_9o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_4o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_3o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_11o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s1o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s2o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s3o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s4o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s5o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s6o.jpg",
      "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_gw.jpg"
    ]
  },
  "contact": {
    "company_name": "(株)タウンハウジング千葉 稲毛店",
    "phone": "043-290-8070",
    "name": "(株)タウンハウジング千葉 稲毛店",
    "headerDetails": [
      "取引態様：仲介",
      "免許番号： 国土交通大臣（１）第９９２７号 / （一社）千葉県宅地建物取引業協会会員 / （公社）首都圏不動産公正取引協議会加盟"
    ],
    "tags": [
      "駅徒歩3分以内",
      "女性スタッフ",
      "多店舗展開",
      "保証人不要相談可",
      "引越会社紹介"
    ],
    "description": "首都圏139店舗のネットワークにて、ご紹介できるお部屋が多数ございます。お気軽にご来店下さいませ。",
    "address": "千葉県千葉市稲毛区小仲台6-1-4",
    "businessHours": "ＡＭ１０：００～ＰＭ７：００定休日： 水曜日",
    "access": "ＪＲ総武線/稲毛駅 歩2分京成千葉線/京成稲毛駅 歩10分",
    "image": "https://img01.suumo.com/front/gazo/fr/front_kaisha/04/175004004/175004004_tgk_w.jpg",
    "detailPage": "https://suumo.jp/chintai/kaisha/kc_030_175004004/"
  },
  "signals": {
    "tags": [
      "動画"
    ],
    "features": [
      "バストイレ別",
      "バルコニー",
      "エアコン",
      "ガスコンロ対応",
      "クロゼット",
      "フローリング",
      "シャワー付洗面台",
      "TVインターホン",
      "浴室乾燥機",
      "オートロック",
      "室内洗濯置",
      "シューズボックス",
      "システムキッチン",
      "角住戸",
      "温水洗浄便座",
      "脱衣所",
      "洗面所独立",
      "洗面化粧台",
      "2口コンロ",
      "BS・CS",
      "敷金不要",
      "照明付",
      "ウォークインクロゼット",
      "保証人不要",
      "単身者相談",
      "24時間緊急通報システム",
      "全居室フローリング",
      "デザイナーズ",
      "2沿線利用可",
      "駅まで平坦",
      "ネット使用料不要",
      "眺望良好",
      "全室南向き",
      "エアコン全室",
      "保証金不要",
      "雨戸",
      "24時間換気システム",
      "平坦地",
      "南面リビング",
      "人感照明センサー",
      "前面棟無",
      "始発駅",
      "2駅利用可",
      "3駅以上利用可",
      "3沿線以上利用可",
      "駅徒歩10分以内",
      "敷地内ごみ置き場",
      "東南向き",
      "セキュリティ会社加入済",
      "都市ガス",
      "洗面所にドア",
      "シャッター",
      "室内物干機",
      "年内入居可",
      "礼金1ヶ月",
      "初期費用30万円以下",
      "IT重説 対応物件",
      "初期費用カード決済可",
      "全室照明付",
      "通風良好"
    ],
    "new_arrival": true,
    "inquiry_text": "空室状況を問い合わせる（無料）"
  },
  "description": {
    "title": "リブリ・都",
    "meta_description": "【SUUMO(スーモ)賃貸】リブリ・都（000107533873）／千葉県千葉市中央区椿森２／東千葉駅の賃貸物件情報です。賃貸マンション、賃貸アパートなどの賃貸住宅情報を探すならSUUMO賃貸。",
    "point": {
      "title": "◆築浅◆ＳＥＣＯＭ搭載！経済的な都市ガス！ネット無料！！",
      "text": "オシャレなデザイナーズ。駅すぐの生活環境良好な物件です。 無料WiFiでリモートワークにも便利！先行申し込み受付中です。お部屋探しは【タウンハウジング千葉店】にお任せください！０４３-２２１-３６００"
    }
  },
  "attributes": {
    "summary": {
      "address": "千葉県千葉市中央区椿森２",
      "station_access": [
        "ＪＲ総武本線/東千葉駅 歩4分",
        "千葉都市モノレール/千葉駅 歩15分",
        "千葉都市モノレール/千葉公園駅 歩5分"
      ],
      "layout": "1K",
      "exclusive_area": "26.08m2",
      "building_age": "築5年",
      "floor": "1階",
      "向き": "南東",
      "property_type": "アパート",
      "layout_detail": "洋7.5 K1.7",
      "structure": "鉄骨",
      "floors": "1階/3階建",
      "built": "2021年9月",
      "insurance": "1.9万円2年",
      "駐車場": "近隣300m15000円",
      "move_in": "'26年7月上旬",
      "transaction_type": "仲介",
      "conditions": "単身者可",
      "store_code": "R01116-115069",
      "suumo_code": "100509695377",
      "total_units": "11戸",
      "last_updated": "2026/06/03",
      "next_update": "2026/06/11",
      "契約期間": [
        "普通借家 2年"
      ],
      "仲介手数料": [
        "1.1ヶ月"
      ],
      "guarantee_company": [
        "保証会社利用必 （ベーシック100）基本料：月額支払合計の100％ 、学生プラン:基本保証料：15，000円、月額料：月額支払合計の1.1％"
      ],
      "initial_costs": [
        "合計3.19万円（内訳：鍵交換代：24200円/リブリクラブ入会費:7700円）"
      ],
      "other_costs": [
        "更新料新賃料(ヶ月):1.00ヶ月、リブリクラブ月額会費:2200円/月"
      ],
      "remarks": [
        "◆築浅◆ＳＥＣＯＭ搭載！経済的な都市ガス！ネット無料！！オシャレなデザイナーズ。駅すぐの生活環境良好な物件です。 無料WiFiでリモートワークにも便利！先行申し込み受付中です。お部屋探しは【タウンハウジング千葉店】にお任せください！０４３-２２１-３６００"
      ],
      "parking": "近隣300m15000円",
      "contract_duration": [
        "普通借家 2年"
      ]
    },
    "media_links": {
      "video_url": "https://suumo.smbb.jp/dvic/smbbmovieplay.php?feed=M15557353M547e7-c3V1bW8xLnNtYmIuanA=.xml&akey=15557353M547e7-c3V1bW8xLnNtYmIuanA=&siteid=suumo.smbb.jp&config=Msuumoplayer&vkey=bind&viralflag=0&embedflag=1&autostart=0&preview=0&volume=0&ukey=040_SUUMO_FR301FD011_100509695377_PC",
      "print_url": "https://suumo.jp/chintai/bc_100509695377/printout/"
    },
    "gallery_images": [
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_go.jpg",
        "alt": "建物外観 現地待ち合わせ歓迎♪お問合せはタウンハウジング千葉店まで！",
        "number": "1"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_co.jpg",
        "alt": "間取り図",
        "number": "2"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_ro.jpg",
        "alt": "居室・リビング 同型モデルイメージ写真となります。",
        "number": "3"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_2o.jpg",
        "alt": "キッチン 同型モデルイメージ写真となります。",
        "number": "4"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_1o.jpg",
        "alt": "バス・シャワールーム 同型モデルイメージ写真となります。",
        "number": "5"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_5o.jpg",
        "alt": "トイレ 同型モデルイメージ写真となります。",
        "number": "6"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_8o.jpg",
        "alt": "収納 同型モデルイメージ写真となります。",
        "number": "7"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_6o.jpg",
        "alt": "その他部屋・スペース 同型モデルイメージ写真となります。",
        "number": "8"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_7o.jpg",
        "alt": "洗面設備 洗面",
        "number": "9"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_10o.jpg",
        "alt": "バルコニー 同型モデルイメージ写真となります。",
        "number": "10"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_9o.jpg",
        "alt": "セキュリティ 同型モデルイメージ写真となります。",
        "number": "11"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_4o.jpg",
        "alt": "その他設備 同型モデルイメージ写真となります。",
        "number": "12"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_3o.jpg",
        "alt": "玄関 同型モデルイメージ写真となります。",
        "number": "13"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_11o.jpg",
        "alt": "その他共有部分 お部屋探しはタウンハウジング千葉店へお任せください。",
        "number": "14"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s1o.jpg",
        "alt": "スーパー アコレ（スーパー）まで460m",
        "number": "15"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s2o.jpg",
        "alt": "スーパー オーケーマート（スーパー）まで790m",
        "number": "16"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s3o.jpg",
        "alt": "スーパー ヤックス（スーパー）まで1110m",
        "number": "17"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s4o.jpg",
        "alt": "その他 千葉駅（その他）まで790m",
        "number": "18"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s5o.jpg",
        "alt": "その他 東千葉駅(JR 総武本線)（その他）まで520m",
        "number": "19"
      },
      {
        "url": "https://img01.suumo.com/front/gazo/fr/bukken/377/100509695377/100509695377_s6o.jpg",
        "alt": "その他 千葉大学（その他）まで1570m",
        "number": "20"
      }
    ],
    "source_payloads": {
      "suumo_project_data": [
        {
          "ryoikiShuCd": "040",
          "ryoikiShuNm": "賃貸",
          "todaysNewFlg": "1",
          "newFlg": "0",
          "shinkiFlg": "1",
          "shinchikuFlg": "0",
          "manyPhotoFlg": "1",
          "tokushuKeisaiFlg": "1",
          "areaCd": "030",
          "areaNm": "関東",
          "todofukenCd": "12",
          "shikugunCd": "101",
          "todofukenNm": "千葉県",
          "shikugunNm": "千葉市中央区",
          "shikugunKukuriCd1": "12",
          "shikugunKukuriNm1": "千葉県",
          "shikugunKukuriCd3": "101",
          "shikugunKukuriNm3": "千葉市中央区",
          "ensenCd1": "0585",
          "ensenNm1": "ＪＲ総武本線",
          "ekiCd1": "32030",
          "ekiNm1": "東千葉",
          "tohoJikan1": "4",
          "busJikan1": "0",
          "ensenCd2": "0595",
          "ensenNm2": "千葉都市モノレール",
          "ekiCd2": "24180",
          "ekiNm2": "千葉",
          "tohoJikan2": "15",
          "busJikan2": "0",
          "ensenCd3": "0595",
          "ensenNm3": "千葉都市モノレール",
          "ekiCd3": "24190",
          "ekiNm3": "千葉公園",
          "tohoJikan3": "5",
          "busJikan3": "0",
          "chinryo": "69000",
          "chushajoRyo": "15000",
          "chukaiTesuryo": "75900",
          "tatemonoShuCd": "2",
          "chikugonensu": "5",
          "madoriDisp": "1K",
          "madoriKukuri1": "02",
          "madoriKukuri2": "2",
          "mensekiDisp": "26.08",
          "nyukyoDateKbn": "3",
          "kanrihi": "4000",
          "shikikin": "0",
          "reikin": "69000",
          "upd_flg": "1",
          "bukkenCd": "100509695377",
          "kaisha_cd": "175004",
          "mado_cd": "004",
          "gamen_type": "20",
          "hashEmail": ""
        }
      ]
    },
    "search_context": {
      "title": "千葉市中央区、千葉市若葉区の賃貸住宅[賃貸マンション・アパート]情報 検索結果",
      "caption": "千葉市中央区、千葉市若葉区エリア30259件の物件をご紹介！賃貸マンション・賃貸アパート・貸家などの賃貸住宅を借りるなら、お部屋探しのSUUMO（スーモ）。エリア・沿線・建物の種類・人気テーマ・条件など豊富な検索機能で、千葉市中央区、千葉市若葉区周辺の賃貸マンション・賃貸アパート情報をお届けし、あなたの賃貸情報探し・お家探しをサポートします。",
      "total_listings": 30259,
      "requested_url": "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=12&sc=12101&sc=12104&cb=0.0&ct=9999999&et=9999999&cn=9999999&mb=0&mt=9999999&shkr1=03&shkr2=03&shkr3=03&shkr4=03&fw2=&srch_navi=1"
    }
  },
  "source_context": {
    "source_url": "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=12&sc=12101&sc=12104&cb=0.0&ct=9999999&et=9999999&cn=9999999&mb=0&mt=9999999&shkr1=03&shkr2=03&shkr3=03&shkr4=03&fw2=&srch_navi=1",
    "detail_scraped_at": "2026-06-03T10:22:41.382Z"
  }
}

Field Reference

Rental Listing Record

url (string, required): Public Suumo.jp listing URL.

listing_type (string, required): Listing category, such as rental.

title (string, required): Listing title or property name.

property.building_id / property.unit_id (string, optional): Stable Suumo.jp listing identifiers.

property.name / property.building_name (string, optional): Property and building names.

property.property_type (string, optional): Property type label.

pricing.rent (string, optional): Rent as displayed on Suumo.jp, usually in Japanese yen units.

pricing.management_fee (string, optional): Management or administration fee.

pricing.deposit / pricing.key_money (string, optional): Deposit and key money values.

pricing.guarantee / pricing.amortization (string, optional): Guarantee and amortization values when available.

location.address (string, optional): Property address.

transport (array of strings, optional): Station and walking-access descriptions.

layout.floor (string, optional): Listed floor.

layout.floor_plan (string, optional): Floor plan, such as 1K.

layout.area (string, optional): Unit area, typically in square meters.

layout.built (string, optional): Building age summary.

layout.building_meta (array of strings, optional): Additional building metadata such as age and total floors.

media.primary_image / media.building_image (string, optional): Primary and building image URLs.

media.images (array of strings, optional): Additional image URLs.

contact.company_name / contact.name (string, optional): Public agency or contact name.

contact.phone (string, optional): Public contact phone number when shown.

contact.headerDetails (array of strings, optional): Public agency license, role, or transaction details.

contact.tags (array of strings, optional): Agency-level tags.

contact.description (string, optional): Agency description.

contact.address (string, optional): Agency address.

contact.businessHours (string, optional): Public business hours.

contact.access (string, optional): Agency access or nearby station information.

contact.image (string, optional): Agency image URL.

contact.detailPage (string, optional): Agency detail page URL.

signals.tags (array of strings, optional): Listing badges or tags.

signals.features (array of strings, optional): Amenities, features, and property highlights.

signals.new_arrival (boolean, optional): Whether the listing is marked as newly available.

signals.inquiry_text (string, optional): Public inquiry label shown for the listing.

description.title (string, optional): Description title.

description.meta_description (string, optional): Listing meta description.

description.point.title / description.point.text (string, optional): Highlight title and descriptive listing text.

attributes.summary.address (string, optional): Address repeated in the enriched summary.

attributes.summary.station_access (array of strings, optional): Station access values repeated in the enriched summary.

attributes.summary.layout / attributes.summary.layout_detail (string, optional): Layout and layout detail.

attributes.summary.exclusive_area (string, optional): Exclusive area, typically in square meters.

attributes.summary.building_age / attributes.summary.built (string, optional): Building age and construction date.

attributes.summary.floor / attributes.summary.floors (string, optional): Unit floor and building floor context.

attributes.summary.向き (string, optional): Facing direction.

attributes.summary.property_type (string, optional): Property type label.

attributes.summary.structure (string, optional): Building structure.

attributes.summary.insurance (string, optional): Insurance cost or term when listed.

attributes.summary.駐車場 / attributes.summary.parking (string, optional): Parking information.

attributes.summary.move_in (string, optional): Move-in timing.

attributes.summary.transaction_type (string, optional): Transaction type.

attributes.summary.conditions (string, optional): Occupancy or contract conditions.

attributes.summary.store_code (string, optional): Store reference code.

attributes.summary.suumo_code (string, optional): Suumo.jp listing code.

attributes.summary.total_units (string, optional): Total units when available.

attributes.summary.last_updated / attributes.summary.next_update (string, optional): Listing update dates.

attributes.summary.契約期間 / attributes.summary.contract_duration (array of strings, optional): Contract duration details.

attributes.summary.仲介手数料 (array of strings, optional): Brokerage fee details.

attributes.summary.guarantee_company (array of strings, optional): Guarantee company terms.

attributes.summary.initial_costs / attributes.summary.other_costs (array of strings, optional): Initial and recurring cost details.

attributes.summary.remarks (array of strings, optional): Additional remarks.

attributes.media_links.video_url / attributes.media_links.print_url (string, optional): Related media and print URLs.

attributes.gallery_images (array of objects, optional): Gallery image objects.

attributes.gallery_images.url (string, optional): Gallery image URL.

attributes.gallery_images.alt (string, optional): Gallery image alt text.

attributes.gallery_images.number (string, optional): Gallery image ordering value.

attributes.source_payloads.suumo_project_data (array of objects, optional): Additional structured listing attributes available in the output.

attributes.source_payloads.suumo_project_data.ryoikiShuCd / attributes.source_payloads.suumo_project_data.ryoikiShuNm (string, optional): Area or listing category codes and labels when included.

attributes.source_payloads.suumo_project_data.todaysNewFlg / attributes.source_payloads.suumo_project_data.newFlg / attributes.source_payloads.suumo_project_data.shinkiFlg / attributes.source_payloads.suumo_project_data.shinchikuFlg / attributes.source_payloads.suumo_project_data.manyPhotoFlg / attributes.source_payloads.suumo_project_data.tokushuKeisaiFlg / attributes.source_payloads.suumo_project_data.upd_flg (string, optional): Listing flags represented as source-provided values.

attributes.source_payloads.suumo_project_data.areaCd / attributes.source_payloads.suumo_project_data.areaNm / attributes.source_payloads.suumo_project_data.todofukenCd / attributes.source_payloads.suumo_project_data.todofukenNm / attributes.source_payloads.suumo_project_data.shikugunCd / attributes.source_payloads.suumo_project_data.shikugunNm (string, optional): Area, prefecture, and municipality codes and labels.

attributes.source_payloads.suumo_project_data.shikugunKukuriCd1 / attributes.source_payloads.suumo_project_data.shikugunKukuriNm1 / attributes.source_payloads.suumo_project_data.shikugunKukuriCd3 / attributes.source_payloads.suumo_project_data.shikugunKukuriNm3 (string, optional): Additional location grouping codes and labels.

attributes.source_payloads.suumo_project_data.ensenCd1 / attributes.source_payloads.suumo_project_data.ensenNm1 / attributes.source_payloads.suumo_project_data.ekiCd1 / attributes.source_payloads.suumo_project_data.ekiNm1 / attributes.source_payloads.suumo_project_data.tohoJikan1 / attributes.source_payloads.suumo_project_data.busJikan1 (string, optional): First transit line, station, walk time, and bus time values.

attributes.source_payloads.suumo_project_data.ensenCd2 / attributes.source_payloads.suumo_project_data.ensenNm2 / attributes.source_payloads.suumo_project_data.ekiCd2 / attributes.source_payloads.suumo_project_data.ekiNm2 / attributes.source_payloads.suumo_project_data.tohoJikan2 / attributes.source_payloads.suumo_project_data.busJikan2 (string, optional): Second transit line, station, walk time, and bus time values.

attributes.source_payloads.suumo_project_data.ensenCd3 / attributes.source_payloads.suumo_project_data.ensenNm3 / attributes.source_payloads.suumo_project_data.ekiCd3 / attributes.source_payloads.suumo_project_data.ekiNm3 / attributes.source_payloads.suumo_project_data.tohoJikan3 / attributes.source_payloads.suumo_project_data.busJikan3 (string, optional): Third transit line, station, walk time, and bus time values.

attributes.source_payloads.suumo_project_data.chinryo / attributes.source_payloads.suumo_project_data.kanrihi / attributes.source_payloads.suumo_project_data.shikikin / attributes.source_payloads.suumo_project_data.reikin / attributes.source_payloads.suumo_project_data.chushajoRyo / attributes.source_payloads.suumo_project_data.chukaiTesuryo (string, optional): Source-provided rent, fee, deposit, key money, parking, and brokerage fee values.

attributes.source_payloads.suumo_project_data.tatemonoShuCd / attributes.source_payloads.suumo_project_data.chikugonensu / attributes.source_payloads.suumo_project_data.madoriDisp / attributes.source_payloads.suumo_project_data.madoriKukuri1 / attributes.source_payloads.suumo_project_data.madoriKukuri2 / attributes.source_payloads.suumo_project_data.mensekiDisp / attributes.source_payloads.suumo_project_data.nyukyoDateKbn (string, optional): Source-provided building, age, layout, area, and move-in category values.

attributes.source_payloads.suumo_project_data.bukkenCd / attributes.source_payloads.suumo_project_data.kaisha_cd / attributes.source_payloads.suumo_project_data.mado_cd / attributes.source_payloads.suumo_project_data.gamen_type / attributes.source_payloads.suumo_project_data.hashEmail (string, optional): Additional source-provided listing, agency, display, and contact reference values.

attributes.search_context.title (string, optional): Search page title associated with the record.

attributes.search_context.caption (string, optional): Search page caption or summary.

attributes.search_context.total_listings (number, optional): Total listings shown for the source search context.

attributes.search_context.requested_url (string, optional): Source URL for the search context.

source_context.source_url (string, optional): Input or source URL associated with the record.

source_context.detail_scraped_at (string, optional): ISO timestamp for detail collection.

Data Quality, Guarantees, And Handling

• Structured records: results are normalized into predictable JSON objects for downstream use.
• Best-effort extraction: fields may vary by region, session, availability, and Suumo.jp interface changes.
• Optional fields: null-check optional fields in downstream code, especially contact, media, summary, and enriched detail fields.
• Deduplication: use property.unit_id or property.building_id when available, with url as a fallback stable key.
• Freshness: results reflect the publicly available data at run time.
• Repeated runs: use the recommended idempotency key when syncing data into warehouses, CRMs, or search indexes.

Tips For Best Results

• Start with a small limit to validate the output shape before scaling up.
• Use one geography, category, or market segment per run when you need cleaner segmentation.
• Use direct listing URLs when you need exact known properties rather than discovery.
• Use broader Suumo.jp result URLs when the goal is market coverage or discovery.
• Enable enrich_data for fuller property records, media, feature, and contact details.
• Schedule recurring runs for monitoring workflows instead of relying on manual one-off collection.
• Use stable identifiers for deduplication when storing results over time.

How To Run On Apify

1. Open the actor in Apify Console.
2. Configure the available input fields for the target scope.
3. Set the maximum number of outputs to collect with limit.
4. Click Start and wait for the run to finish.
5. Review the dataset records.
6. Download results in JSON, CSV, Excel, or other supported formats.

Scheduling & Automation

Scheduling

Automated Data Collection

You can schedule runs to keep Suumo.jp datasets fresh for reporting, monitoring, enrichment, or warehouse ingestion. Recurring schedules are useful when tracking changes in pricing, availability, and listing attributes over time.

• Navigate to Schedules in Apify Console
• Create a new schedule, such as daily, weekly, or custom cron
• Configure input parameters
• Enable notifications for run completion
• Add webhooks for automated processing

Integration Options

• BI dashboards: monitor rent, availability, property types, amenities, and geographic coverage over time.
• Data warehouses: store recurring snapshots for historical analysis, trend reporting, and market intelligence.
• CRM enrichment: sync public property and agency attributes into account, lead, or territory records.
• Google Sheets or Airtable: review smaller market samples, validate records, or coordinate lightweight operations.
• Webhooks: trigger validation, notification, or ingestion workflows after each completed run.
• Alerts and scheduled reports: notify teams when tracked listing segments change across repeated runs.

Export Formats And Downstream Use

Apify datasets can be exported or consumed by downstream systems for analytics, operations, and automated data delivery.

• JSON: for APIs, applications, and data pipelines
• CSV or Excel: for spreadsheet workflows and manual review
• API access: for automated ingestion into internal systems
• BI and warehouses: for reporting, dashboards, and historical analysis

Performance

Estimated run times:

• Small runs (< 1,000 outputs): ~3-5 minutes
• Medium runs (1,000-5,000 outputs): ~5-15 minutes
• Large runs (5,000+ outputs): ~15-30 minutes

Execution time varies based on filters, result volume, and how much information is returned per record. Highly filtered runs can finish faster, while broad discovery or detail-rich records may take longer.

Limitations

• Availability depends on what https://suumo.jp publicly exposes at run time.
• Some optional fields may be missing on sparse listings or pages with limited public data.
• Very broad searches may take longer or require a higher limit to collect the expected coverage.
• Target-side changes can affect field availability, labels, or naming.
• Regional, account, or availability differences may change visible results.
• Public listing data can change between repeated runs.

Troubleshooting

• No results returned: check that each startUrls value is a valid public Suumo.jp URL and that the page contains matching public records.
• Fewer results than expected: raise limit, use a broader source URL, or verify that Suumo.jp contains enough matching records for the selected scope.
• Some fields are empty: optional fields depend on what each listing publicly provides.
• Run takes longer than expected: reduce scope, lower limit for validation, or split broad collection into smaller segments.
• Output changed: compare the current output with the field reference and report a small sample if support is needed.

FAQ

What data does this actor collect?

It collects public Suumo.jp real estate listing data, including property identifiers, title, pricing, location, transport access, layout, images, contact information, features, descriptions, and listing context when available.

Can I filter by location, category, date, price, or other criteria?

The actor accepts Suumo.jp URLs through startUrls. Configure location, category, price, or other criteria on Suumo.jp first, then use the resulting public URL as an input.

Can I collect a specific property listing?

Yes. Add the direct Suumo.jp listing URL to startUrls and use a small limit.

Why did I receive fewer results than my limit?

The limit is a maximum, not a guarantee. The final count depends on how many matching public records are available from the provided URL and how much of that scope can be collected during the run.

Can I schedule recurring runs?

Yes. Use Apify schedules to run the actor daily, weekly, or on a custom cadence for monitoring and reporting workflows.

How do I avoid duplicates across runs?

Use property.unit_id or property.building_id when available. If those identifiers are missing, use url as a fallback key for deduplication and upserts.

Can I export the data to CSV, Excel, or JSON?

Yes. Apify datasets support exports in JSON, CSV, Excel, and other formats supported by the Apify platform.

Does this actor collect private data?

No. The actor is intended to collect publicly available information from Suumo.jp. Users are responsible for using the data lawfully and responsibly.

What should I include when reporting an issue?

Include the input used, redacted if needed, the run ID, expected behavior, actual behavior, and a small output sample when helpful.

Compliance & Ethics

Responsible Data Collection

This actor collects publicly available real estate listing information from https://suumo.jp for legitimate business purposes, including:

• Real estate research and market analysis
• Property monitoring and operational reporting
• Data enrichment for internal analytics and decision-support workflows

Users are responsible for ensuring that their use of collected data complies with applicable laws, regulations, and the target site's terms. This section is informational and not legal advice.

Best Practices

• Use collected data in accordance with applicable laws, regulations, and the target site's terms
• Respect individual privacy and personal information
• Use data responsibly and avoid disruptive or excessive collection
• Do not use this actor for spamming, harassment, or other harmful purposes
• Follow relevant data protection requirements where applicable, such as GDPR or CCPA

Support

For help, use the Issues tab or the actor page in Apify Console. Include the input used, redacted if needed, the run ID, expected versus actual behavior, and a small output sample when available. Avoid sharing secrets or sensitive data in support requests.