LIFULL HOMES Japan Sale Scraper — 中古マンション & 一戸建て

Scrape for-sale property listings from LIFULL HOME'S (homes.co.jp), Japan's second-largest real estate portal. Covers resale condos (中古マンション), new condos (新築マンション), resale detached homes (中古一戸建て), new detached homes (新築一戸建て), and land (土地) — by prefecture.

What you get

Each listing record contains:

Field	Description
listing_id	HOMES listing ID from the URL
title	Listing title (e.g. "センチュリーパークタワー 49階")
transaction_type	sale_new / sale_resale / land
property_type	mansion_resale / mansion_new / detached_resale / detached_new / land
prefecture	Prefecture slug (e.g. tokyo)
city	City or ward (e.g. 中央区)
district	District / chome
address_ja	Full Japanese address
price_jpy	Price in yen
price_usd	Price in USD (converted at run time)
price_per_sqm_jpy	Price per m² in yen
building_year	Year built
building_age_years	Age in years
building_area_sqm	Floor area (m²)
land_area_sqm	Land area (m²)
rooms_layout	Room layout (e.g. 3LDK)
direction	Exposure direction (e.g. 南向き)
building_structure	Structure (SRC, RC, 木造, etc.)
floors_total	Total floors in building
floor_location	Unit floor number
management_fee_jpy	Monthly management fee (yen)
repair_reserve_jpy	Monthly repair reserve (yen)
management_company	Property management company
nearest_station	Nearest station name
station_distance_min	Walk time to station (minutes)
train_line	Train line name
zoning	Zoning class (用途地域)
renovation_history	Renovation history summary
photos	Photo URLs (pipe-separated, up to 20)
description_ja	Japanese listing description
broker_name	Listing broker / agency name
listing_url	Direct URL on homes.co.jp
scraped_at	Scrape timestamp (ISO 8601)

Input options

Prefectures

Select one or more of Japan's 47 prefectures. Defaults to tokyo, kanagawa, osaka.

Listing Category

Value	Property type
mansion_resale	Resale condo (中古マンション) — default
mansion_new	New condo (新築マンション)
detached_resale	Resale detached home (中古一戸建て)
detached_new	New detached home (新築一戸建て)
land	Land (土地)

Scrape Detail Pages

When enabled (default: true), follows each listing link to collect enriched data: station access, floor layout, management fees, building structure, zoning, renovation history, and photos. Disable for faster summary-only runs.

Include USD Prices

When enabled (default: true), converts the JPY price to USD using a live exchange rate fetched from open.er-api.com at run start. Falls back to a hardcoded rate (~149 JPY/USD) if the API is unavailable.

Max Items

Maximum listings to return. Defaults to 10. Set to 0 for unlimited (full prefecture crawl).

Proxy Configuration

Residential proxy is strongly recommended — HOMES blocks datacenter IPs. The default configuration uses Apify's RESIDENTIAL proxy group.

How it works

1. Seed: Generates listing page URLs for each selected prefecture and category (e.g. https://www.homes.co.jp/mansion/chuko/tokyo/list/).
2. Listing pages: Extracts all listings from the embedded JSON-LD ItemList block — price, area, year built, address, and listing URL.
3. Detail pages (when scrapeDetails: true): Follows each listing URL and parses the HTML table for station access, layout, fees, structure, zoning, photos, and broker info.
4. Pagination: Automatically follows next-page links until maxItems is reached or no more pages exist.

Performance notes

• Concurrency is capped at 3 to respect HOMES rate limits with residential proxy rotation.
• A full Tokyo mansion_resale crawl (1000+ listings) takes around 30-60 minutes depending on proxy speed.
• Set scrapeDetails: false to skip detail pages and run ~5x faster.

Use cases

• Japanese real estate market analysis
• Price-per-sqm tracking across prefectures
• Investment property research
• Building age and structure distribution analysis
• Station proximity valuation studies

Legal notice

Always comply with HOMES.co.jp's Terms of Service when using scraped data. This tool is intended for research and analysis purposes.