# SUUMO 日本房产 Japan Real Estate Price, Rent & Yield Stats (`jpmarketdata/suumo-market-cn`) Actor

日本房产、日本买房行情一次调用即得：输入5位市区町村代码，从 SUUMO（日本最大的房产门户）取回该市区的租金行情（中位数、每平方米单价、管理费、押金/礼金比例、楼龄）与二手公寓售价行情（价格、每平方米单价、建成年份），并自动算出表面收益率估算。附美元换算。适合日本房产投资、移居选址与市场调研。From $0.02 per area, no subscription.

- **URL**: https://apify.com/jpmarketdata/suumo-market-cn.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 market summary — one city × property types

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

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

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

***

### 中文说明

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

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

数据来自 [SUUMO](https://suumo.jp)，日本最大的房产门户。每个市区一次调用返回：

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

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

本 Actor 是英文版 [SUUMO Japan Real Estate](https://apify.com/jpmarketdata/suumo-market-checker) 的**中文语言包**：抓取逻辑与统计口径完全相同，只有标题、商店说明、文档和输入项标签改写成中文。

#### 概览 Overview

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

#### 输入 Input

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

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

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

#### 输出 Output

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

```json
{
  "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
}
```

```json
{
  "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](https://apify.com/jpmarketdata/suumo-market-checker). 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)](https://apify.com/jpmarketdata/athome-rent-market-cn) 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](https://apify.com/jpmarketdata/suumo-market-checker)（取得・統計処理は同一）。賃貸側は姉妹パッケージ [at home 日本租金行情](https://apify.com/jpmarketdata/athome-rent-market-cn) が担当し、本 Actor は売買市場を担当します。

#### 入力 Input

`cityCodes`（市区町村コード5桁、例 `13113`=渋谷区、`27127`=大阪市北区。[コード一覧（総務省）](https://www.soumu.go.jp/denshijiti/code.html)）／`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

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

# Actor input Schema

## `cityCodes` (type: `array`):

一个或多个日本市区町村代码（全国地方公共団体コード的前5位）。例如：13113 = 东京涩谷区、13104 = 东京新宿区、27127 = 大阪市北区、26102 = 京都市上京区、01101 = 札幌市中央区。完整代码表：https://www.soumu.go.jp/denshijiti/code.html

## `propertyType` (type: `string`):

'rent' 分析租赁房源，'buy' 分析二手公寓（中古マンション）的在售房源。'both' 会分别抓取两套数据、分开汇总，并为每个市区加上表面收益率估算（$0.02 × 2 条汇总）。

## `maxListingsPerCity` (type: `integer`):

每个市区（按房产类型分别计）取样多少套房源。30 = 一个结果页。件数越多统计越稳。仅在开启「输出单套房源」时才影响费用（+$0.002/套）。

## `includeIndividualListings` (type: `boolean`):

默认关闭：一次运行每条汇总（市区 × 房产类型）固定 $0.02。开启后还会输出每一套取样房源（租金/售价、面积、户型、楼龄、地址、链接），费用 +$0.002/套。

## `convertToUsd` (type: `boolean`):

按当前汇率（open.er-api.com）在日元统计旁边附上美元统计。

## Actor input object example

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

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cityCodes": [
        "13113"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/suumo-market-cn").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "cityCodes": ["13113"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/suumo-market-cn").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cityCodes": [
    "13113"
  ]
}' |
apify call jpmarketdata/suumo-market-cn --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/suumo-market-cn",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KOtrWyWzi1e805cyR/builds/Wu7fBaklMjfmZhJOq/openapi.json