SUUMO Scraper — Japan Property Data & API 🏯

🎉 Turn Japan's #1 property portal into clean, structured data — one row per room, ready for analysis

For real-estate analysts, investors, relocation agents, and data teams working the Japanese rental & sale market

---

📋 Overview

Need Japanese rental and sale listings as clean data instead of endless scrolling? This scraper turns SUUMO search results into structured JSON/CSV — and it does the one thing most SUUMO tools get wrong: it explodes each building into one row per rentable room, so price, layout, area and floor are per-unit, exactly how you'd analyze them.

Why analysts and agencies choose us:

• ✅ Per-room rows: a building with 5 vacant units becomes 5 clean records — no nested mess
• ⚡ Fast & lightweight: direct extraction, no slow headless browser, no proxy overhead
• 🎯 40+ data points: price (normalised to JPY), 万円 raw text, layout, area, floor, deposit, key money, building age, station access, photos
• 💴 Pay-per-result: only pay for listings you actually receive — transparent and cheap
• 💎 Two depths: fast overview for whole-market sweeps, full detail for the building spec table (structure, year built, total units, direction)
• ✨ Three ways in: by prefecture code, by pasted SUUMO search URL (keeps every filter), or by listing URL

---

✨ Features

• 🏢 Rent listings, done right — explodes 賃貸 building cards into per-room records
• 💴 Money normalised — 10.2万円 becomes 102000 JPY and keeps the original string
• 📐 Price-per-m² built in — yield and comparison math ready out of the box
• 🚉 Station access — every 沿線/駅 walk-time line captured
• 🔎 Detail enrichment — structure, year built, total units, direction, transaction type, full photo set
• 🔗 Paste-a-URL mode — apply filters in SUUMO's UI, paste the link, every filter is preserved
• 📦 Clean exports — JSON, CSV, Excel straight from the dataset
• 🌐 Optional Japan proxy — off by default, available as a one-click escape hatch

---

🎬 Quick Start

Pick a mode, give it a prefecture code or a SUUMO search URL, and run. Listings stream into your dataset as clean rows. Export as JSON, CSV, or Excel.

curl -X POST https://api.apify.com/v2/acts/sian.agency~suumo-property-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "searchMode": "byPlace", "section": "rent", "places": ["13"]}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your input

Enter a prefecture code (e.g. 13 for Tokyo), paste a SUUMO search URL, or list specific listing URLs.

Step 2: Pick depth

overview for fast whole-market room cards, or detail for the full building spec table.

Step 3: Run & export

Start the run and download your results as JSON, CSV, or Excel.

That's it! In under a minute, you'll have:

• A clean, per-room dataset
• Prices normalised to JPY plus the raw 万円 strings
• Layout, area, floor, deposit, station access, and photos

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (fast room cards) or detail (full spec table)
searchMode	string	No	byPlace, bySearchUrl, or byListingUrl
section	string	No	rent (full support) or sale verticals
places	array	No	SUUMO prefecture codes, e.g. ["13"] (Tokyo)
searchUrls	array	No	Pasted SUUMO search URLs (filters preserved)
listingUrls	array	No	SUUMO detail URLs or bukken codes (detail mode)
filters	array	No	Extra SUUMO query filters as key=value
maxResults	integer	No	Max listings per run (FREE: 25, PAID: unlimited)

Example — overview by prefecture:

{
  "scrapeMode": "overview",
  "searchMode": "byPlace",
  "section": "rent",
  "places": ["13"],
  "maxResults": 200
}

Example — detail by search URL:

{
  "scrapeMode": "detail",
  "searchMode": "bySearchUrl",
  "searchUrls": ["https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&ta=13&pc=50"]
}

---

📤 Output

Results are saved to the Apify dataset with 40+ fields per listing, including:

Field	Type	Description
listingId	string	SUUMO bukken code
url	string	Canonical listing URL
price	number	Rent/sale price in JPY
price_formatted	string	Raw 10.2万円 string
price_per_sqm_jpy	number	Computed price per m²
layout	string	間取り, e.g. 1K, 2LDK
area_sqm	number	専有面積 in m²
floor	string	Room floor
deposit / key_money	string	敷金 / 礼金
building_age / year_built	string	Age / 築年月
station_access	array	沿線/駅 walk-time lines
address	string	所在地
images	array	Photo URLs
structure / total_units / direction	string	Detail-mode spec fields

Example:

{
  "listingId": "100512520556",
  "url": "https://suumo.jp/chintai/bc_100512520556/",
  "propertyTitle": "CF COURT",
  "price": 102000,
  "price_formatted": "10.2万円",
  "price_per_sqm_jpy": 3474,
  "layout": "1K",
  "area_sqm": 29.36,
  "admin_fee": 6000,
  "address": "東京都文京区千石４",
  "station_access": ["都営三田線 巣鴨駅 歩7分"],
  "structure": "鉄筋コン",
  "year_built": "2007年2月",
  "image_count": 23
}

---

💼 Use Cases & Examples

1. Rental Market Research

Analysts mapping rent-by-area across a prefecture. Input: prefecture code + rent section · Output: per-room dataset with price & m² · Use: build a rent heatmap by ward and station.

2. Property Investment Analysis

Investors comparing yields across buildings. Input: a filtered SUUMO search URL · Output: price-per-m² on every unit · Use: rank candidate buildings by gross yield.

3. Relocation & Tenant Search

Relocation agents shortlisting homes for clients. Input: prefecture + layout/budget filters · Output: clean rows with deposit, key money, station walk-time · Use: hand clients a tidy comparison sheet.

4. Real-Estate Lead Generation

Agencies building prospect lists of active listings. Input: broad search by area · Output: building, address, layout, contact-ready records · Use: feed CRM pipelines.

5. Price & Trend Monitoring

Data teams tracking rent movements over time. Input: scheduled runs on the same search · Output: snapshots to diff week-over-week · Use: detect price changes and new inventory.

6. Academic & Policy Research

Researchers studying Japanese housing markets. Input: multiple prefectures · Output: structured, reproducible datasets · Use: quantitative housing studies.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/suumo-property-scraper').call({
  scrapeMode: 'overview', searchMode: 'byPlace', section: 'rent', places: ['13']
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/suumo-property-scraper').call(
    run_input={'scrapeMode': 'overview', 'searchMode': 'byPlace', 'section': 'rent', 'places': ['13']}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~suumo-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "searchMode": "byPlace", "section": "rent", "places": ["13"]}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, notify, or sync to CRM

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 listings per run — full feature access, same quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited listings per run
• Pay-per-result: only charged for listings you actually receive

💴 Cheap by design — direct extraction with no proxy overhead keeps the per-listing price among the lowest for Japanese real-estate data.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many listings can I scrape? A: FREE tier: 25 per run. PAID tier: unlimited.

Q: Why does a building appear as several rows? A: That's the point — SUUMO lists vacant rooms under one building, and we give you one clean row per room so price, layout and area are per-unit.

Q: Do I need a SUUMO account or API key? A: No. Just provide a prefecture code or a search URL.

Q: What output formats are available? A: JSON, CSV, and Excel — export directly from the Apify dataset.

Q: Are GPS coordinates included? A: SUUMO does not expose latitude/longitude in its listing pages, so those fields are empty. Address and station access are included.

Q: What's the difference between overview and detail? A: Overview is the fast room-card data. Detail fetches each listing's full page for extra building specs (structure, year built, total units, direction) and merges them in.

---

🐛 Troubleshooting

No results returned

• Check the prefecture code (e.g. 13 for Tokyo) or that the pasted URL is a SUUMO search-results page.
• For sale verticals, use section: rent for the richest data — sale templates have partial coverage.

Fewer rows than expected

• FREE tier caps at 25 listings per run — upgrade for unlimited.
• Narrow filters in the SUUMO UI may simply return fewer listings.

A specific listing failed in detail mode

• The listing may have expired or been delisted; the run continues and skips it.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Disclaimer: This is an independent tool and is not affiliated with, endorsed by, or sponsored by SUUMO or Recruit Co., Ltd. "SUUMO" is a trademark of its respective owner. Use this actor in compliance with SUUMO's terms of service and all applicable laws.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools