🏠 Suumo Scraper

Search Suumo, Japan's largest rental listings site, with no login: every nearby supermarket, convenience store, and drugstore with its exact walking distance, a full amenities list, energy and insulation ratings, listing freshness dates, and agent contact, well beyond rent and floor plan.

Paste a real Suumo search URL or a list of listing URLs, and get export-ready data for relocation services, rental market research, and listing monitoring.

🎯 Who uses it?

🚚 Relocation & expat housing services

Amenities, nearby facilities, and station access for matching clients to real listings.

📈 Rental market researchers

Pricing, layout, and area trends by ward or station.

🔔 Listing monitors

Track last-updated and next-update dates to catch genuinely fresh listings.

🏢 Property comparison tools

A consistent, structured record per room for building comparison tables.

✨ What it does

• Search: paste a real Suumo search-results URL and this Actor walks every page of it, one row per real room.
• Detail: enrich a specific list of listing URLs directly.
• Optional full detail: adds, on every row, exact-distance nearby facilities, the full amenities tag list, energy and insulation performance, insurance, guarantor terms, transaction type, total units, free-text agent notes, listing last-updated and next-update dates, and agent contact.

Missing source values are returned as null, never invented.

Why this scraper

• Nearby facilities with exact walking distances, structured. Not a vague "near shops" tag, the real supermarket, convenience store, or drugstore name, category, and distance in meters, parsed into clean fields.
• A full amenities list, not a summary. 20 to 28 real tags per listing (layout details, guarantor requirements, gas type, network availability, and more), not a handful of headline features.
• Listing freshness you can actually monitor. Real last-updated and next-scheduled-update dates on every enriched row.
• Reliable under real load. Tested at 1,000 rooms with zero duplicates and zero missing core fields.
• No login, no API key. Just a real Suumo search URL.

How it compares

Checked directly against the closest real competitor on Apify (their own declared input/output):

Capability	This actor	Closest competitor
Nearby facilities with exact distances	yes	not documented
Full amenities tag list	yes	not documented
Listing last-updated / next-update dates	yes	not documented
Every real Suumo search filter honored	yes, via real search URL	yes
Tested at 1,000-row scale	yes, verified clean	not documented

📦 What data you get

Entity	Useful fields
Listing	Building name and type, address, station access, floor, rent, management fee, deposit, key money, layout, area, orientation, structure, built date, and real listing photos.
Nearby & amenities	Every nearby facility with its name, category, and exact distance in meters, plus the full amenities tag list.
Building performance	Energy performance, insulation performance, insurance, guarantor requirement, parking, move-in terms, and other initial costs.
Freshness & contact	Real last-updated and next-scheduled-update dates, agent name and phone, transaction type, and total units.

Every record includes scraped_at (UTC). Download your dataset from Apify as CSV, JSON, Excel, or XML.

💡 Use cases

🔎 Search a real Suumo URL

{ "mode": "search", "searchUrl": "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=13&sc=13104&pc=30" }

🧩 Search with full details on every room

{
  "mode": "search",
  "searchUrl": "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=13&sc=13104&pc=30",
  "fetchDetails": true
}

📇 Enrich specific listings

{ "mode": "detail", "detailUrls": ["https://suumo.jp/chintai/bc_100527528612/"] }

⚙️ How the input is organised

Pick a mode and a maximum results cap first, then fill in the matching section:

Section	What it's for
Search mode	A real Suumo search-results URL (copy it from your browser after setting filters on suumo.jp), plus how many pages to walk and whether to fetch full detail on every room.
Detail mode	A list of specific Suumo listing URLs to enrich directly.

Apify Free plan: every run is limited to a fixed 10-row sample. Upgrade your Apify plan to run your own settings.

🛡️ Limits & responsible use

This Actor reads only Suumo's own public listing pages. It never signs in and never accesses anything gated behind an account.

energy_performance and insulation_performance are usually null because Suumo itself leaves these blank on most real listings, especially older buildings, a real gap in what's disclosed, not something this Actor can fill in. Coverage in this version is rental listings; Suumo's own sale and land verticals are not yet included.

If a listing page can't be loaded, its row is still saved with whatever was available plus an error field.

📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

Local development

bun install
bun test                       # offline: parsing, normalization (real fixtures)
bun run src/main.ts             # reads storage/key_value_stores/default/INPUT.json