Japan Real Estate API
The Japan Real Estate API returns Japanese property listings as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns items with listing id, URL, Japanese title and address, price (JPY), madori (layout) and area (m2), and you can pull a detail, areas and a separate listings search and detail. It is built for real-estate tools and Japanese property analytics that need this data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/japan-re/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"prefecture": "tokyo",
"listing_type": "rent",
"max_pages": 1
}
}{
"ok": true,
"meta": {
"api": "japan-re",
"endpoint": "search",
"mode": "live",
"latency_ms": 6552.8,
"record_count": 66,
"bytes": 493478,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "max_pages",
"method": "suumo_ssr",
"prefecture": "tokyo",
"listing_type": "rent",
"page": 1,
"filters_applied": {}
},
"data": {
"items": [
{
"listing_id": "[redacted-phone]",
"bukken_code": "[redacted-phone]",
"source": "suumo",
"listing_type": "rent",
"transaction_type": "rent",
"url": "https://suumo.jp/chintai/jnc_[redacted-phone]/?bc=[redacted-phone]",
"title_ja": "YOU I COURT",
"address_ja": "東京都杉並区浜田山３",
"price_jpy": 115000,
"price_ja": "11.5万円",
"admin_fee_jpy": null,
"madori": "1K",
"madori_ja": "1K",
"area_m2": 25.25,
"station_access": [
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
}
],
"building_age_years": 7,
"photos": [
"https://img01.suumo.com/front/gazo/fr/bukken/560/[redacted-phone]/[redacted-phone]_ro.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/560/[redacted-phone]/[redacted-phone]_co.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/560/[redacted-phone]/[redacted-phone]_go.jpg"
]
},
{
"listing_id": "[redacted-phone]",
"bukken_code": "[redacted-phone]",
"source": "suumo",
"listing_type": "rent",
"transaction_type": "rent",
"url": "https://suumo.jp/chintai/jnc_[redacted-phone]/?bc=[redacted-phone]",
"title_ja": "京王新線 初台駅 3階建 築21年",
"address_ja": "東京都渋谷区本町２",
"price_jpy": 148000,
"price_ja": "14.8万円",
"admin_fee_jpy": 6000,
"madori": "1LDK",
"madori_ja": "1LDK",
"area_m2": 37.44,
"station_access": [
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
}
],
"building_age_years": 21,
"photos": [
"https://img01.suumo.com/front/gazo/fr/bukken/218/[redacted-phone]/[redacted-phone]_ro.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/218/[redacted-phone]/[redacted-phone]_co.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/218/[redacted-phone]/[redacted-phone]_go.jpg"
]
},
{
"listing_id": "[redacted-phone]",
"bukken_code": "[redacted-phone]",
"source": "suumo",
"listing_type": "rent",
"transaction_type": "rent",
"url": "https://suumo.jp/chintai/jnc_[redacted-phone]/?bc=[redacted-phone]",
"title_ja": "グリーンヒル",
"address_ja": "東京都八王子市川口町",
"price_jpy": 66000,
"price_ja": "6.6万円",
"admin_fee_jpy": 4000,
"madori": "1LDK",
"madori_ja": "1LDK",
"area_m2": 40.07,
"station_access": [
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
},
{
"access_ja": "[trimmed-depth]",
"walk_minutes": "[trimmed-depth]",
"bus_minutes": "[trimmed-depth]"
}
],
"building_age_years": 17,
"photos": [
"https://img01.suumo.com/front/gazo/fr/bukken/337/[redacted-phone]/[redacted-phone]_go.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/337/[redacted-phone]/[redacted-phone]_co.jpg",
"https://img01.suumo.com/front/gazo/fr/bukken/337/[redacted-phone]/[redacted-phone]_ro.jpg"
]
}
],
"count": 66,
"prefecture": "tokyo",
"listing_type": "rent",
"page": 1,
"pages_fetched": 1,
"has_next_page": true,
"next_page": 2
}
}What the Japan Real Estate API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search SUUMO property listings in any of Japan's 47 prefectures — rentals or homes for sale (used house / used condo / land / new house) — filtered by max price (万円), min area (m²), max station walk-time, building age and a free-text station/area keyword. Paginate with page + max_pages. | Real-estate investors call search to search SUUMO property listings in any of Japan's 47 prefectures. | prefecture, listing_type, page, max_pages, max_price_man, ... |
| detail | Full detail for one SUUMO listing — rent/deposit/key-money or sale price, madori layout, floor area, floor, orientation, building structure & age, station access and the photo gallery. For RENT pass listing_id; for SALE pass the listing's `url` from a search result (SUUMO sale pages have no id-only URL). listing_type picks the right parser. | Brokerage tools call detail to get full detail for one SUUMO listing. | listing_id, url, listing_type |
| areas | List Japan's 47 prefectures with their romaji slug, kanji name and SUUMO region/JIS codes — use it to discover or validate the `prefecture` value before searching. Pass an optional query to filter by name. | Property dashboards call areas to list Japan's 47 prefectures with their romaji slug, kanji name and SUUMO region/JIS codes. | query |
| listings/search | Alias of `search` (legacy name). Prefer `search`. | Lead-generation teams call listings/search to get alias of `search` (legacy name). | prefecture, listing_type, page, max_pages, max_price_man, ... |
| listings/detail | Alias of `detail` (legacy name). Prefer `detail`. | Real-estate investors call listings/detail to get alias of `detail` (legacy name). | listing_id, url, listing_type |
Call search from your stack
curl -X POST https://api.reefapi.com/japan-re/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"prefecture":"tokyo","listing_type":"rent","max_pages":1}'import requests
r = requests.post(
"https://api.reefapi.com/japan-re/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"prefecture": "tokyo",
"listing_type": "rent",
"max_pages": 1
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/japan-re/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"prefecture": "tokyo",
"listing_type": "rent",
"max_pages": 1
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.japan-re.search with {"prefecture":"tokyo","listing_type":"rent","max_pages":1}.Who uses this API and why
- Investors call search to track Japanese listing prices by area.
- Dashboards use detail and madori to enrich a property.
- Analysts use areas to size a Japanese market.
Questions developers ask before integrating
What is the Japan Real Estate API?
Japan Real Estate API is a ReefAPI endpoint group for japan property listings and details. It returns live JSON through POST requests under /japan-re/v1.
Is the Japan Real Estate API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Japan Real Estate calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Japan Real Estate login or account?
No login to Japan Real Estate is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Japan Real Estate data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Japan Real Estate API use?
Japan Real Estate actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Japan Real Estate from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call japan-re actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Japan Real Estate API a Japan Real Estate scraper?
It is the managed alternative to a DIY Japan Real Estate scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same japan property listings and details back as clean JSON.
Why does my Japan Real Estate scraper keep getting blocked?
Most Japan Real Estate scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.