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, or ward-by-ward across Tokyo's 23 special wards.

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)
ward	Tokyo ward slug the listing was found under (ward-filtered runs only, e.g. shibuya)
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.

Tokyo Wards

Scrape Tokyo ward-by-ward instead of prefecture-wide. Select any of the 23 special wards (chiyoda, chuo, minato, shinjuku, bunkyo, taito, sumida, koto, shinagawa, meguro, ota, setagaya, shibuya, nakano, suginami, toshima, kita, arakawa, itabashi, nerima, adachi, katsushika, edogawa). When set, Tokyo is seeded per ward (added automatically even if tokyo is missing from Prefectures), each record carries a ward field, and full pagination runs within each ward. Other selected prefectures are scraped whole as usual. Leave empty for prefecture-wide scraping.

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.