SUUMO Data Parser & API
SUUMO is Japan’s largest property portal — ~30M monthly visits (Similarweb, late 2025) and ~8M listings — and PropAPIS extracts its rental, resale, new-build, commercial and land data, including floor plans, photos, station walk-time and building age, through a single REST API. Owned by Recruit Holdings, SUUMO carries the richest residential field set in East Asia, and PropAPIS serves it without you building or maintaining a JS-heavy scraper.
| Country | Japan |
|---|---|
| Type | Portal |
| Owner | Recruit Holdings |
| Listing types | rental, resale, new-build, commercial, land |
| Monthly visits | ~30M / mo |
| Active listings | ~8M |
| API access | No public API (parse-only) |
| Parse priority | ★★★★★ |
| Official site | suumo.jp |
Platform Overview
Market Position
- Japan’s #1 property portal: ~30M monthly visits (Similarweb, late 2025)
- ~8M active listings — the largest inventory in the region (Grokipedia)
- Owned by Recruit Holdings, leading a three-horse race ahead of LIFULL HOME’S (~17.7M) and AtHome (~11.2M)
- Best-in-class structured residential fields: layout codes, building age, station walk-time
Market Coverage
Geographic Coverage:
- All 47 prefectures of Japan
- Greater Tokyo, Osaka, Nagoya and regional metros
- Urban and rural listings
Property Types:
- Apartments / mansions (分譲・賃貸マンション)
- Houses (一戸建て)
- New-build developments (新築)
- Commercial property
- Land and plots
Data Availability
SUUMO is the most field-rich residential source in the region. Listings carry floor plans, photo galleries, layout codes (e.g. 2LDK), nearest-station walk-time and building age — the structured residential detail East-Asia portals are known for (per the East & Southeast Asia research report). Note: comprehensive agent-only data flows through REINS (the broker MLS, not public), and official transaction prices come from the separate MLIT government API; SUUMO is the public consumer layer.
Listing Categories:
- Rent: Long-term residential rentals (賃貸)
- Buy: Resale apartments and houses (中古)
- New: New-build developments (新築)
- Commercial: Offices, retail, business property
- Land: Plots and development land
Data Fields Available
PropAPIS extracts structured data from each SUUMO listing:
Property Information
- Address: Prefecture, city, ward and district
- Price: Rent or sale price
- Layout: Layout code (1K, 2LDK, etc.) and floor plan image
- Property Type: Apartment, house, new-build, land
- Area: Floor area (m²)
- Building Age: Year built / age in years
Rental-Specific Data
- Management Fee: Monthly management / common-area fee
- Key Money: Reikin (礼金)
- Deposit: Shikikin (敷金)
- Guarantor / Renewal terms where shown
Listing Details
- Description: Full listing text
- Photos: Image URLs and floor-plan images
- Station Distance: Nearest station and walk-time (minutes)
- Added / Updated Date
Location Data
- Prefecture, City and Ward
- Nearest Station and Line
- Coordinates: Latitude and longitude where published
API Endpoints
Get Property Details
from propapis import PropAPIS
api = PropAPIS(api_key='your_api_key')
# Get a listing by URL or ID
property_data = api.platforms.suumo.get_property(
listing_id='12345678'
)
print(f"Title: {property_data.title}")
print(f"Price: ¥{property_data.price:,}")
print(f"Layout: {property_data.layout}")
print(f"Station: {property_data.station} ({property_data.walk_minutes} min)")
print(f"Building age: {property_data.building_age}")Search Listings
# Search SUUMO listings
listings = api.platforms.suumo.search(
prefecture='Tokyo',
purpose='rent',
min_price=80000,
max_price=200000,
layout='2LDK'
)
for listing in listings[:10]:
print(f"{listing.title} - ¥{listing.price:,}")
print(f" {listing.layout} | {listing.station} {listing.walk_minutes}min")Quick Start
from propapis import PropAPIS
api = PropAPIS(api_key='your_api_key')
# Search SUUMO rentals in Tokyo
listings = api.platforms.suumo.search(prefecture='Tokyo', purpose='rent')
for listing in listings[:5]:
print(f"{listing.title} - ¥{listing.price:,}")import { PropAPIS } from 'propapis';
const api = new PropAPIS({ apiKey: 'your_api_key' });
// Search SUUMO rentals in Tokyo
const listings = await api.platforms.suumo.search({
prefecture: 'Tokyo',
purpose: 'rent',
});
listings.slice(0, 5).forEach((l) => {
console.log(`${l.title} - ¥${l.price.toLocaleString()}`);
});curl "https://api.propapis.com/v1/platforms/suumo/search?prefecture=Tokyo&purpose=rent" \
-H "Authorization: Bearer your_api_key"