Suumo Scraper - Japanese Real Estate API

Extract real estate listings from suumo.jp, Japan's #1 property portal. Returns rich structured data per listing: rent, deposit, key money, layout, floor area, building age, train access, and full image gallery.

What you get per listing

• listingId, url - Suumo listing token and direct link
• listingType - rent or sale
• propertyType - Japanese property label (e.g. 賃貸マンション, 賃貸アパート, 中古マンション)
• buildingName - Building name in Japanese
• address - Full address in Japanese
• city - Ward or city parsed from the address (e.g. 渋谷区, 横浜市)
• trainAccess - Array of train lines + walking time to nearest stations
• rentPriceYen, managementFeeYen - Monthly rent and management fee in JPY (rent only)
• depositYen (敷金), keyMoneyYen (礼金) - Standard Japanese upfront fees (rent only)
• salePriceYen - Total sale price in JPY (sale only)
• layout - Layout code 1K, 1LDK, 3LDK, etc.)
• areaSqm, floor, buildingAgeYears, totalFloors
• imageUrl, imageUrls - Cover + full gallery
• scrapedAt

How to use

Type a Japanese city or Tokyo ward, pick rent or sale.

{ "city": "Shibuya", "listingType": "rent", "maxItems": 200 }

Other examples:

{ "city": "Minato",   "listingType": "rent", "maxItems": 100 }
{ "city": "Osaka",    "listingType": "rent", "maxItems": 100 }
{ "city": "Yokohama", "listingType": "sale", "maxItems": 50  }
{ "city": "Kyoto",    "listingType": "rent", "maxItems": 100 }

Supported cities: all 23 Tokyo wards (Chiyoda, Chuo, Minato, Shinjuku, Bunkyo, Taito, Sumida, Koto, Shinagawa, Meguro, Ota, Setagaya, Shibuya, Nakano, Suginami, Toshima, Kita, Arakawa, Itabashi, Nerima, Adachi, Katsushika, Edogawa) plus Yokohama, Kawasaki, Saitama, Chiba, Osaka, Kyoto, Kobe, Nagoya, Sapporo, Fukuoka, Sendai, Hiroshima.

Power-user mode: for finer filters (price range, layout, station distance, min year built), set them on suumo.jp, copy the URL from your browser, paste into searchUrl. The structured inputs are bypassed.

Common use cases

Investor monitoring - track new listings across Tokyo, Osaka, Yokohama. Compare yields by ward.

Relocation agencies - source apartments for expat clients moving to Japan.

Real estate funds - portfolio-track rent levels and vacancy signals across major Japanese markets.

Price benchmarking - rent per square meter by city and layout.

Pricing

Pay per result. See the Pricing tab. Failed runs cost nothing.

Notes

Each Suumo "building" can have multiple rooms listed; each room is returned as a separate listing.

Pagination is automatic, set your desired maxItems and the actor walks through pages until it has enough or runs out.

Deposit (敷金) and key money (礼金) are non-refundable Japanese rental upfront fees, typically 1-2 months of rent each.

Tags

japan, tokyo, suumo, real estate, property, rental, apartment, chintai, japanese real estate

Found a bug or have a feature request? Open an issue and I respond within 24h.