Japan Real Estate Market Stats — for Chinese-Speaking Buyers & Investors

中文 · English · 日本語 —— 输入一个日本市区町村代码，一次调用拿到 SUUMO 的租金行情、二手公寓售价行情，以及由两者算出的表面收益率估算。

---

中文说明

这是给谁用的（Who this is for）

「日本房产」是中文圈里长期存在、且金额最大的一类查询——买房自住、移居、投资收租、资产配置，问题都落在同一句话上：这个区到底多少钱、租得出去吗、回报率大概是多少。我们的姊妹语言包 at home 日本租金行情 覆盖的是租这一侧；这一个覆盖的是买卖市场——二手公寓（中古マンション）的售价行情，并且和租金放在同一条记录旁边，直接给出表面收益率。

数据来自 SUUMO，日本最大的房产门户。每个市区一次调用返回：

• 租金汇总 —— 租金的中位数与四分位、每平方米租金、管理费中位数、押金（敷金）与礼金（礼金）的普及率、楼龄中位数、主流户型。
• 售价汇总（二手公寓 / 中古マンション） —— 价格中位数、每平方米单价、建成年份中位数、主流户型。
• 表面收益率估算 —— 每平方米租金中位数 × 12 ÷ 每平方米售价中位数，这是投资者横向比较区域时最经典的第一道数字。
• 可选：每一套取样房源（价格、面积、户型、楼龄、地址、链接）。

价格以日元给出，可选附上美元换算。数据按需从 SUUMO 的公开搜索页获取，运行之间不存储任何数据。

本 Actor 是英文版 SUUMO Japan Real Estate 的中文语言包：抓取逻辑与统计口径完全相同，只有标题、商店说明、文档和输入项标签改写成中文。

概览 Overview

一个市区 × 一种房产类型 = 一条汇总记录。选 both 时会分别给出租赁与买卖两条汇总，再加一条 yield_estimate（收益率估算不额外收费）。

输入 Input

字段	示例	说明
cityCodes	["13113"]	5 位市区町村代码。13113 = 涩谷区、13104 = 新宿区、27127 = 大阪市北区、01101 = 札幌市中央区。官方完整代码表
propertyType	"both"	rent（租赁）、buy（二手公寓在售）或 both（两者 + 收益率估算）
maxListingsPerCity	60	每个市区、每种类型的取样量（30–300）
includeIndividualListings	false	开启后每一套房源输出一条记录（+$0.002/套）
convertToUsd	true	按当前汇率附上美元统计

{
    "cityCodes": ["13113"],
    "propertyType": "both",
    "maxListingsPerCity": 60,
    "includeIndividualListings": false,
    "convertToUsd": true
}

常用市区代码：涩谷区 13113 / 新宿区 13104 / 港区 13103 / 中央区 13102 / 丰岛区 13116 / 大阪市北区 27127 / 京都市中京区 26104 / 福冈市中央区 40133 / 札幌市中央区 01101。

输出 Output

字段名保持英文，这是 API 接口：

{
  "type": "rent_summary",
  "cityCode": "13113",
  "areaLabel": "東京都渋谷区",
  "totalListingsFound": 75005,
  "sampledUnits": 60,
  "rentJpy": {"min": 49000, "p25": 64000, "median": 65000, "p75": 65750, "max": 80000, "average": 64933},
  "rentPerM2Jpy": {"median": 3799, "...": "..."},
  "adminFeeJpyMedian": 10000,
  "pctWithDeposit": 76.7,
  "pctWithGratuity": 80.0,
  "medianBuildingAgeYears": 35
}

{
  "type": "yield_estimate",
  "cityCode": "13113",
  "grossYieldPct": 3.04,
  "medianRentPerM2Jpy": 3799,
  "medianSalePricePerM2Jpy": 1500276
}

怎么读：rentPerM2Jpy.median 与 medianSalePricePerM2Jpy 是跨区域比较时唯一可比的两个数（不受户型大小影响）；pctWithDeposit / pctWithGratuity 是日本特有的租赁惯例，直接决定入住的一次性成本；grossYieldPct 是表面收益率，不含税费、管理成本与空置率。

每项统计的口径（basis）

• totalListingsFound 是 SUUMO 页面显示的命中数，其中包含多家中介重复挂出的同一套房源，因此它是市场厚度的量级指标，不是精确的房源数。
• 所有价格统计都是样本统计，样本量为 sampledUnits（由 maxListingsPerCity 决定）。想要更稳的分布就调高它。
• grossYieldPct 是估算值：租赁与在售两个池子的规模、面积构成与楼龄构成并不相同，因此它是区域间的横向比较指标，不是对某一套房产的分析。

本 Actor 不做什么

• 不做单套房产的估值。 它给的是区域行情，不是对某一套房子的定价意见。
• 不含税费与持有成本。 表面收益率不扣除取得税、登记费、固定资产税、管理费、修缮基金、空置率与中介费——净收益率要在这之上自己算。
• 不做新房（新築マンション）与一户建的行情。 买卖侧只覆盖二手公寓（中古マンション）。
• 不做成交价。 SUUMO 是挂牌信息，价格是要价，不是成交价。
• 不处理个人数据。 只读公开搜索页，不采集中介或房东的个人信息。
• 不做时间序列。 每次运行是一个快照；要看趋势请自行定时运行并保存。

价格 Pricing —— 每条汇总 $0.02，无订阅

计费事件	价格	何时发生
市区行情汇总（area-analyzed）	$0.02	每个市区 × 每种房产类型（例如 both = 租赁 + 买卖 = $0.04）。收益率估算免费
单套房源记录（listing-scraped）	$0.002	仅当开启「输出单套房源」时

默认运行（1 个市区、both、只要汇总）花费 $0.04。零结果的市区绝不收费。 Apify 每月赠送 $5 免费额度。

注意事项 Notes & limits

• totalListingsFound 是 SUUMO 的显示命中数，包含多家中介重复挂出的房源。
• 收益率估算是指示性的：租赁与在售房源在规模与年份构成上并不一致，它不是针对具体房产的分析。
• 只读且限速，按需抓取公开搜索页。无需登录，不涉及个人数据。
• 与株式会社リクルート（SUUMO 运营方）无任何关联。数据用于市场调研，购房等重大决策前请务必自行核实。

用途 Use cases

• 投资与分析 —— 一次 API 调用就能按租金水平、每平方米单价与表面收益率横向比较区域。
• 移居与置业服务 —— 让客户看清一个街区真实的成本，包括押金/礼金这类日本惯例。
• 市场研究 —— 按需追踪日本各城市的租金与价格水位。

---

English

Overview

Rent and used-condo price statistics for any Japanese city, plus a gross-yield estimate. One call per city returns a rent summary (median and quartile rent, rent per m², admin fee, how common deposits 敷金 and key money 礼金 are, median building age, top layouts), a sale summary for used condominiums (median price, price per m², median built year, top layouts) and, when both are fetched, a yield_estimate record.

This listing is the Chinese-language package of our English Actor SUUMO Japan Real Estate. The scraping and the statistics are identical; the documentation, store copy and input labels are written for Chinese-speaking buyers and investors (日本房产 / 日本买房). The sister package at home Rent Market (Chinese) covers renting; this one covers the sale market.

Input

Field	Example	Notes
cityCodes	["13113"]	5-digit JIS city/ward codes. 13113 = Shibuya, 13104 = Shinjuku, 27127 = Osaka Kita, 01101 = Sapporo Chuo
propertyType	"both"	rent, buy (used condos) or both (adds the yield estimate)
maxListingsPerCity	60	Sample size per city per type (30–300)
includeIndividualListings	false	Enable to get each listing as a record (+$0.002 each)
convertToUsd	true	Adds USD stats at the current exchange rate

Output

One rent_summary and/or sale_summary record per city, plus a yield_estimate record when propertyType: "both" — see the JSON examples in the Chinese section — plus optionally one record per sampled listing. All price statistics are sample statistics over sampledUnits.

Pricing

Event	Price
Market summary (area-analyzed)	$0.02 per city × property type (both = $0.04). The yield estimate is free
Individual listing (listing-scraped)	$0.002 each

A default run (1 city, both, summaries only) costs $0.04. A city that returns zero listings is never charged. No subscription.

Notes & limits

• totalListingsFound is SUUMO's displayed hit count and includes duplicate listings by multiple agencies.
• Prices are asks, not transaction prices; the sale side covers used condominiums only (no new builds, no houses).
• The yield estimate is indicative: rental and for-sale stock differ in size and age mix, and it excludes taxes, running costs and vacancy. It is not property-level analysis.
• Read-only, throttled, on demand. No login, no personal data, nothing stored between runs. Not affiliated with Recruit Co., Ltd.

---

日本語

概要 Overview

SUUMO の公開検索ページから、市区ごとの賃料相場（中央値・㎡単価・管理費・敷金/礼金の割合・築年数）と中古マンション相場（価格・㎡単価・築年）、および両者から計算する表面利回りの目安を1コールで返します。中国語圏の利用者（日本房产 / 日本买房）向けに中国語で書き直したパッケージで、英語版は SUUMO Japan Real Estate（取得・統計処理は同一）。賃貸側は姉妹パッケージ at home 日本租金行情 が担当し、本 Actor は売買市場を担当します。

入力 Input

cityCodes（市区町村コード5桁、例 13113=渋谷区、27127=大阪市北区。コード一覧（総務省））／propertyType（rent / buy / both、既定 both）／maxListingsPerCity（既定 60、30〜300）／includeIndividualListings（既定 OFF）／convertToUsd（既定 ON）。

出力 Output

市区ごとに rent_summary と sale_summary、both のときは yield_estimate を追加で1件。価格統計はいずれもサンプル基準（母数は sampledUnits）で、totalListingsFound は SUUMO の表示件数（複数業者による重複掲載を含む）です。includeIndividualListings が ON のときは物件ごとの明細も出力します。

料金 Pricing

サマリー（area-analyzed）$0.02（both は賃貸+売買で $0.04。利回り推定は無料）／個別物件レコード（listing-scraped）$0.002 / 件。個別明細は既定 OFF。0件の市区には課金されません。 サブスクリプション不要。

注意 Notes

価格は募集価格であって成約価格ではありません。売買側は中古マンションのみ（新築・戸建ては対象外）。表面利回りはあくまで目安で、賃貸と売買の在庫は規模・築年構成が異なり、税・諸費用・空室率も含みません（物件単位の分析ではありません）。公開検索ページのみをスロットリングしながら読み取り、ログイン不要・個人情報なし・実行間の保存なしです。株式会社リクルートとは無関係です。