LIFULL HOME'S Scraper — Japan Property Data & API 🏠

🎉 Turn Japan's rental market into a clean spreadsheet — one row per room, photos, rent, layout, area & station access in seconds

Built for real-estate analysts, relocation services, proptech teams & investors who need fresh Japanese property data on tap

---

📋 Overview

Researching the Japanese rental market by hand is slow — homes.co.jp lists every building, and each building hides several rentable rooms behind a table. This scraper does the unfolding for you: it turns any prefecture, search, or listing into a clean, structured dataset with one row per room — rent, layout, area, floor, deposit, key money, building age, station access and photos, ready for Excel, Google Sheets, or your database.

Why teams choose this scraper:

• ✅ One row per room: buildings are exploded into individual rentable units — no manual unfolding
• ⚡ Fast & lightweight: pulls room-level cards straight from search pages, no slow browser farm
• 🎯 Clean, normalized data: rent in integer JPY, area in m², dual rent-per-m² already computed
• 💰 Pay-per-result: only pay for listings you actually receive — generous free tier to test
• 💎 Two depths: a cheap fast Overview, or a rich Detail pass with structure, orientation, equipment, contract terms & the full image set
• ✨ No account, no API key: paste a prefecture or a search URL and run

---

✨ Features

• 🏢 Per-room extraction: every building's room table is expanded into separate, comparable rows
• 🧭 Two scrape modes: Overview (cheap, high-volume) and Detail (full spec table)
• 🔀 Three ways to search: by prefecture slug, by pasted search URL (keeps all your filters), or by direct listing URL
• 🗺️ Rich attributes: layout (間取り), area, floor, deposit, key money, building age, equipment, orientation
• 🚉 Station access: line, station name and walking minutes
• 📐 Computed rent-per-m²: instant value comparison across listings
• 📷 Full photo sets: deduped image URLs, thumbnail-first
• 💴 JPY normalization: 万円 strings parsed to clean integer yen
• 📤 Export anywhere: JSON, CSV, Excel straight from the dataset

---

🎬 Quick Start

Pick a prefecture (or paste a search URL), choose Overview or Detail, and run. Results stream into a clean dataset you can export in one click.

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

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose what to scrape

Enter a prefecture slug (e.g. tokyo, osaka, kanagawa) — or paste a homes.co.jp search URL with your filters applied.

Step 2: Pick a depth

Overview for fast, cheap room-level cards. Detail to enrich each listing with structure, equipment, contract terms and the full image set.

Step 3: Run & export

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

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

• A clean table with one row per rentable room
• Rent, layout, area, floor, deposit, building age & station access
• Photos and a computed rent-per-m² for instant comparison

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (fast cards) or detail (full spec). Default overview.
searchMode	string	No	byPlace, bySearchUrl, or byListingUrl (detail only).
vertical	string	No	rent (賃貸, full coverage) or mansion (used mansion). Default rent.
places	array	No	Prefecture/region slugs, e.g. ["tokyo","osaka"].
searchUrls	array	No	homes.co.jp search-results URLs (keeps your filters).
listingUrls	array	No	Listing URLs or 40-char room hashes (detail mode).
sort	string	No	Result ordering (cheapest, newest, largest, …).
filters	array	No	Extra key=value query filters (price, area, walk minutes).
maxResults	integer	No	Listings per run. FREE: 25 · PAID: unlimited.

Example — overview by prefecture:

{
  "scrapeMode": "overview",
  "searchMode": "byPlace",
  "places": ["tokyo"],
  "sort": "fee",
  "maxResults": 100
}

Example — detail by listing URL:

{
  "scrapeMode": "detail",
  "searchMode": "byListingUrl",
  "listingUrls": ["https://www.homes.co.jp/chintai/room/086345eeb9fb0097804f58b7092da0ce3d50346c/"]
}

---

📤 Output

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

Field	Type	Description
listingId	string	Room hash or building id
propertyTitle	string	Building name
rent	number	Rent normalized to integer JPY
price_per_sqm_jpy	number	Computed rent per m²
layout	string	間取り (ワンルーム / 1K / 2LDK …)
area_sqm	number	専有面積 in m²
floor / floors_total	string	Room floor & building floors
deposit / key_money	string	敷金 / 礼金
build_age / build_date	string	Building age & exact build month
structure	string	建物構造 (detail)
equipment	array	設備・条件 features (detail)
address / access	string	所在地 & station access
images	array	All photo URLs

Example:

{
  "listingId": "086345eeb9fb0097804f58b7092da0ce3d50346c",
  "propertyTitle": "プレシャス方南町",
  "bukken_type": "賃貸マンション",
  "rent": 83000,
  "rent_man": "8.3",
  "price_per_sqm_jpy": 5210,
  "admin_fee": 3000,
  "deposit": "無",
  "key_money": "無",
  "layout": "ワンルーム",
  "area_sqm": 15.93,
  "floor": "3階",
  "floors_total": "3階建",
  "build_age": "1年",
  "address": "東京都杉並区堀ノ内2丁目13-13",
  "access": "東京メトロ丸ノ内線 方南町駅 徒歩8分",
  "url": "https://www.homes.co.jp/chintai/room/086345eeb9fb0097804f58b7092da0ce3d50346c/"
}

---

💼 Use Cases & Examples

1. Rental market research

Analysts tracking rent levels across Tokyo wards. Input: prefecture tokyo, sort by cheapest. Output: per-room rents with area & layout. Use: build rent-per-m² benchmarks by neighborhood.

2. Relocation & corporate housing

Relocation services shortlisting units near a station. Input: a filtered search URL (walk minutes, budget). Output: ranked rooms with access times. Use: present clients a clean comparison sheet.

3. Proptech & data products

Teams powering a rental search app. Input: multiple prefectures on a schedule. Output: fresh structured listings. Use: keep your own database current automatically.

4. Investment & yield analysis

Investors comparing rental yields. Input: target areas + detail mode. Output: rent, area, structure, building age. Use: estimate gross yields and spot mispriced units.

5. Competitive & agency intelligence

Agencies monitoring new listings. Input: sort by newly-listed. Output: the latest rooms on market. Use: react fast to fresh inventory.

---

🔗 Integration Examples

JavaScript/Node.js

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

const run = await client.actor('sian.agency/lifull-homes-property-scraper').call({
  scrapeMode: 'overview',
  searchMode: 'byPlace',
  places: ['tokyo'],
  maxResults: 50,
});

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/lifull-homes-property-scraper').call(
    run_input={'scrapeMode': 'overview', 'searchMode': 'byPlace', 'places': ['osaka'], 'maxResults': 50}
)

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

cURL

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

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule (e.g. daily) or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON dataset
4. Action: Save to a sheet/database or send a notification

---

📊 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
• Faster runs, no caps
• Pay-per-result: you're only charged for listings you actually receive

💰 Transparent pay-per-result pricing — the cheap Overview event powers high-volume jobs, Detail adds the full spec table only when you need it.

🔗 View current pricing

---

❓ Frequently Asked Questions

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

Q: What's the difference between Overview and Detail? A: Overview is the fast, cheap room-level card (rent, layout, area, floor, address). Detail fetches each listing's full page to add structure, orientation, balcony, equipment, contract terms, agency and the full image set.

Q: Can I keep my homes.co.jp filters? A: Yes — apply filters in the homes.co.jp UI, copy the search URL, and use searchMode: bySearchUrl. Every cond[...] filter is preserved.

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

Q: Is the rent normalized? A: Yes — Japanese 万円 strings are parsed to clean integer JPY, and rent-per-m² is computed for you.

Q: Is this legal? A: We only extract publicly available data. See the legal note below.

---

🐛 Troubleshooting

No results returned

• Check the prefecture slug spelling (e.g. tokyo, not Tokyo-to)
• If using a search URL, make sure it's a /list/ results page, not a single listing

Fewer rows than expected

• FREE tier caps each run at 25 listings — upgrade for unlimited
• Narrow filters (price/area/walk minutes) reduce the result pool

Detail run is slow

• Detail fetches one page per listing; lower maxResults or use Overview for high volume

---

⚖️ 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.

Trademark notice: LIFULL HOME'S and homes.co.jp are trademarks of LIFULL Co., Ltd. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by LIFULL Co., Ltd. All product names, logos, and brands are property of their respective owners and are used for identification purposes only.

---

🤝 Support

Join our active support community

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

---

Built by SIÁN Agency | More Tools